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How To Use This Manual 


This manual describes the installation, 
configuration and operation of the File Transfer 
Server software for the Cluster/One Model A and 
PLAN 1000 networks. References to PLAN 1000 
apply equally to Cluster/One Model A. FTS 
packages are available for standalone and 
networked microcomputers. 


The network FTS can run in any station on the 
network, and can serve one or more file server 
stations on the same network or on different 
networks. Data in the form of file server files 
(such as virtual disk volumes, mail messages, 
and spooled print server requests), as well as 
individual Pascal or SOS files within virtual 
Pascal or SOS volumes, can be transferred from 
file server to file server on the same network 
or to a different PLAN 1000 or PLAN 4000 
network. 


The standalone FTS can run on the Apple // or 
Apple ///, transferring Pascal or SOS files to 
another standalone Apple // or Apple ///, or to 
a PLAN 1000 or PLAN 4000 network. 


This manual is organized as follows: 


Chapter 1 introduces the different ways the FTS 
can be used, explains the hardware requirements 
for each of these uses and explains modem 
compatibility requirements. 


Chapter 2 contains installation instructions for 
the following configurations of FTS: FTS on 
stand-alone Apple //, FTS on networked Apple //, 
FTS on stand-alone Apple ///, FTS on networked 
Apple ///. 
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Chapter 3 provides an overview of FTS startup 
and operation, as well as an introduction to the 
syntax and purpose of all of the commands that 
FTS understands. 


Chapter 4 provides a‘detailed description of 
each of the FTS commands and syntax requirements 
to be used as a reference. It includes extended 
examples of FTS command files appropriate for 
standalone and network versions. 


Appendix A is a quick reference quide to FTS 
commands and syntax. 


Appendix B provides details about the 
Clock/Calendar card that is a part of the 
stand-alone FTS package that runs on the 
Apple //. 


Appendices C-G provide details about modems 
supported by FTS. 


Prerequisite manuals are: 


Cluster/One Model A File Server Users Manual 
Publication #LC20-0101. 


Cluster/One Model A File Server System Managers 
Manual Publication #LC20-0102. 


If your installation also has the Messenger (TM) 
electronic mail package, we recommend that you 
read the Messenger Electronic Mail System 
Managers and User’s Guide, 
Publication # GH20-0100. 


iv 3/1/83 


CONTENTS 


Contents 
Disclainersccisccsereewswsieececvesseserweaoeess Lt 
How To Use This MA TU al! ecssosures usss s were vererereie iii 


Contents 60:0 600.8685 :66 OOOO OOS OO TOKE HOS OE OS vi 


Chapter 1 About FTS 


1.0 Introduction. csccccccvcccccccccccccces l-l 
lel Uses Of FTSecckcssenvdcrsaccevesswcess IL 
1.2 Hardware Requirements......cccccccccee 1-4 
1.3 Modem Compatibility ..cccccecescceceee 1-6 
1.4 The Data Transferred weccececsccceseee 1-8 


Chapter 2 Installation 


2.0 Installation. .ccccccccccccscccccvscscce 271 
2.1 Network Apple // FTS Installation..... 2-1 
2.2 Standalone Apple // FTS Installation.. 2-11 
2.3 Network Apple /// FTS Installation ... 2-20 
2.4 Standalone Apple /// FTS 


Installation cccccevcssccccvcccveceses 2-32 
Chapter 3 How FTS Works 


O Introduction. cccccccescccccscscccssccee 371 
1 Automatic Startup Of FIS..eececceseeees 3-1 
2 FTS Prepares to Use the Log and 

Command FileS ceccccecccccccescessccecse 372 
3 Giving FTS Commands from the Keyboard.. 3-5 
4 How FTS Processes Commands....eccceceseee 3-5 
5 How FTS Uses the Clock Calendar Card....3-7 
6 How FTS Uses Multiple Command Files.....3-7 
7 How FTS Updates its Log File........+..2.3-8 


3/1/83 v 


CONTENTS 


Chapter 4 Creating FTS Command Files 
4.0 Keywords and Command LinesS.....eeeeeee- 4-1 
4.1 Syntax of Network FTS Commands 

for Local Transfers..ccccccccccsrecceee 4-3 
4.2 Syntax for Creating and Scheduling 
Procedures eoocccccccvrccccccccsesceeses 4-11] 
Remote TransferSeccccccsccccccccscccces 4-15 
File Server Commands.....cccccecsecvees 4-25 
Macro Definitions ssssesssssscsoscssacse 4-26 
Standalone FTS Command Files ......e2+- 4-27 
Hand Scheduling of Tasks ..cecceeeeeeee 4-32 
More Sample Command Files ...eececceeees 4-32 


Ee a a aE a 
e 
OND US W 


Appendix A Reference Guide 


Aol Keywords .cccccccccccccsccccvccccccsees An] 
A.2 Syntax of FTS Command Lines 

Understood by FTS cessceecccceccveeseee A-I 
A-3 Object Specification. ..ceccccccccceceee A-5 
A.4 Syntax of Procedures. ..seseccceeccecvee AnD 
A.5 Required and Optional Command File 


Components eeeeveeveeeaevpeeoeeeevseeeseeeeeese eee e@ A-6 
Appendix B The Clock/Calendar Card 


B.1 Clock/Calendar Specifications...e.eseee- Bol 
Be2 The SETCLOCK Utility PrOgrame coeecesoee B-2 


Appendix C The Owlmodem 


C.l Installing the Owlmodem.....eceseeeeeee Col 
C.2 "USES" options coerce ereeereereseeeeeereee Cc-1 


Appendix D Novation APPLE-CAT // Modem 
D.1 Installing the Novation APPLE-CAT II 


MOd Gis: sees oe ead Wssie hee OTe Te eee ec weds DRL 
D.2 "USES" options des HOTASUDS TOT RS Sees DAZ 


vi 3/1/83 


CONTENTS 


Appendix E Hayes Micromodem II 


1 Installing the Hayes Micromodem II .... E-1 
2 “USES” options weer eeseeeereceoesereeeeoeeee E-1 


E 
E 
Appendix F The Hayes Smartmodem 


F.1 Installing the Hayes Smartmodem........ F-1 
F.2 Configuring the RS232 Driver ...sesseee F- 
F 3 "USES" options esceooocooooooooooooooooo F-3 


N 


Appendix G The Hayes Smartmodem 1200 


G.1 Installing the Hayes Smartmodem 1200... G-1 
G.2 Configuring the RS232 Driver ....sseseee G2 
G 3 “USES” options eoeeoereoeeereeeeseereeeoeeseoe G-3 


Index eoeeeeeeoeereseseeeeeeoeesneeeeoeeereeee eee I-1 


Readers Comment Form 


3/1/83 vii 


ABOUT FTS 


Chapter 1 


About FTS 


1.0 Introduction 


In this chapter we explain the fundamental 
purposes of the File Transfer Server and provide 
lists of required hardware for different 
configurations. 


If your installation will be using FTS for 
remote transfers, you will need to select a 
modem that is compatible with the modems of the 
remote FTS stations. We list the supported 
modems and discuss compatibility issues. 


Finally, we explain the types of data that can 
be transferred using FTS. 


1.1 Uses of FTS 

FTS can be used in several basic ways: 

* standalone microcomputers with compatible 
” modems can transfer data between their local 


drives, provided they are each running FTS 
software. 


File Transfer Server File Transfer Server 


ws i —— 


Disk Disk 
ep Z — dD 
modem modem 


Standalone to standalone 
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* network workstations running FTS can transfer 


data on one file server or between multiple 
file servers on the same network. 


Network File Server Network File Server 


a - E 
m _i = 
Disk Disk 
i 
File Transfer Server 


Local transfer on one File Server or between 
multiple File Servers on one network 


network workstations running FTS can transfer 
data between connected networks provided: they 


have network interface cards for each network 
they are serving. 


Network File Server Network File Server 


m p 


Disk 





File Transfer Server 


Local transfer between connected networks 
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network workstations can transfer data to 
remote FTS networks. Each network involved 
in the transfer must have a workstation that 
is running FTS at the time of the transfer. 
And, both FTS stations must have compatible 
modems. 


Network File Server Network File Server 
Disk Disk 


File Transfer modem modem File Transfer 
Server Server 





Network to network remote transfer - 


standalone microcomputers with modems can run 
the FTS software, enabling them to send and 
receive data to and from a PLAN 1000 or PLAN 
4000 network. Network workstations can 
transfer data to remote standalone FTS 
stations. Each station involved in the 
transfer must be running FTS at the time of 
transfer, and both stations have compatible 
modems. 





Network File Server File Transter Server 
cs w 


Disk Disk 


-n — am —, am 


File Transfer modem modem 
Server 


Network to standalone and 
standalone to network 
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Networked microcomputers running FTS can be used 
in conjunction with applications such as the 
Messenger (TM) electronic mail and Print Server 
subsystem packages. Virtual volumes created by 
these applications can be transferred from one 
file server disk to another on the same or 
connected networks, or over telephone lines to 
remote networks. Chapter 4 contains an extended 
example of a command file that is used for this 
purpose. 


1.2 Hardware Requirements 


A networked microcomputer becomes a file 
transfer server when it is running properly 
configured file transfer server software. It 
must be connected to a modem if it is to 
transfer data to standalone microcomputers’ that 
are also running FTS, or to remote networks that 
have a microcomputer station running FTS. 


If it is to transfer data on the same ora 
connected network, the networked microcomputer 
does not require a modem, but must have a 
network interface card for each connected 
network that it will service. 


An Apple // used as a standalone FTS station 
must have: 


* one of the following modems: 
the Owlmodem 
the Apple-CAT II Modem 


the D.C. Hayes Micromodem II 


* the Clock/Calendar Card (included in the 
Apple // standalone FTS package) 
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*. one 5.25" floppy disk controller, and two 
5.25" floppy disk drives 


An Apple /// used as a standalone FTS station 
must have: 


* one of the following modems: 


D.C. Hayes Smartmodem 
D.C. Hayes Smartmodem 1200 


* a second 5.25" floppy disk drive or a Profile 
hard disk in addition to the built-in floppy 
disk drive. 


An Apple // used as a network FTS station must 
have: 


* one of the following modems (if it is to 
transfer files to separate networks or 
standalone FTS stations): 


the Owlmodem 
the Apple-CAT II Modem 
the D.C. Hayes Micromodem II 


* a network interface card for every network 
segment it serves. It can serve up to six 
network segments (seven if no modem card is 
installed) 


* a 5.25" floppy disk drive and controller to 
accomplish the installation procedure. After 
installation is completed, the mini-floppy 
disk drive can be detached, as long as it is 
available for occasional use. 


NOTE: the file server station must have a Nestar 
Clock/Calendar card, if a network is to support 
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an FTS station. 


An Apple /// used as a network FTS station must 
have: 


* one of the following modems: 


D.C. Hayes Smartmodem 
D.C. Hayes Smartmodem 1200 


* a network interface card for every network 
segment it serves. It can serve up to three 
network segments. 


NOTE: the file server station must have a Nestar 
Clock/Calendar card, if a network is to support 
an FTS station. 


Workstations on the network can be used as FTS 
stations when FTS software is executed on them. 
They need not be, but can be, dedicated as 
full-time file transfer server stations. 
Another possibility, is to devote a network 
workstation to FTS duties part time and to other 
duties for the remainder of the day. 


1.3 Modem Compatibility 


Two FTS stations can not transfer data to each 
other via telephone lines unless their modems 
are compatible. The following chart and its 
associated notes show which modems are 
compatible. 


1-6 3/1/83 


ABOUT FTS 


Compatibility Chart 
(Network or Standalone) 


FROM 
Micro CAT Owl Smart Smart 
II TL Modem Modem 
1200 
TO 
Micro YES l NO YES 1 
II 
CAT 2 YES YES 2 1&2 
II 
Owl NO YES YES NO NO 
Smart YES 1 NO YES 1 
modem 
Smart 2 1&2 NO 2 YES 
Modem 
1200 


l. 


The SITE command in the command file of the 
originator must contain a "USES 300” clause 
that FTS will pass to its modem driver, 
causing the Bell 103 mode to be selected when 
calling that site (see Chapter 4). 


The MYSITE command in the command file of the 
answering site must contain a "USES 300" 
clause that FTS will send to its modem 
driver, causing the Bell 103 mode to be 
selected when answering incoming calls (see 
Chapter 4). 


3/1/83 1-7 


ABOUT FTS 


1.4 The Data Transferred 


Any of the following objects can be transferred 


as 


l. 


a unit by the FTS: 


File server virtual volumes that are Apple // 
Pascal (T=P), Apple // DOS (T=D), Apple // 
CP/M (T=C), or Apple /// SOS (T=3) virtual 
volumes. The entire contents of the virtual 
volume, including the directory, allocated 
space and unused space, is copied. The 
destination volume is created and formatted 
appropriately by FTS at the time of the 
transfer. 


File server virtual volumes that are binary 
memory images (T=B). The destination file 
will be constructed with the same 
characteristics (memory load address, memory 
size, and file size) as the original. 


Note: A networked Apple /// cannot perform 
local transfers of - binary volumes, nor 
receive a binary volume from a remote FTS, 
but may send one to a remote Apple // FTS. 


File server virtual volumes that are T=T 
(text files), such as files spooled by the 
Network Print System and Messenger mail 


system. 


For network to network only, file server 
directories. that contain any of the above 
volume types. Although the directory itself 
is. not copied, any non-directory volumes 
contained within it are transferred and 
created under a single directory at the 
destination. Thus, a collection of volumes 
may be transferred without specifying (or 
knowing) what the individual volumes are. The 
NFS directories are searched in nested 
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fashion, so the volumes within entire 
subtrees may be transferred. 


5. (Stand-alone only) Real volumes that are 
Apple // Pascal, DOS, CP/M, or Apple /// SOS 
formatted. Real volumes are assumed to be 280 
blocks (size of .a diskette) except for 
Apple // Pascal, which may be smaller, 
depending on how many blocks were zeroed. 


NOTE: Network versions of FTS cannot send or 
receive data from real disks. 


6. Apple // Pascal files within Pascal volumes 
(virtual or real) and Apple /// SOS files 
within SOS volumes (virtual or real). The 
file may be any legal Pascal or SOS type 
(TEXT, CODE, etc). Pascal files are managed 
by both Pascal and SOS, while SOS files are 
only recognized by SOS. 


Note that a real volume can be transferred to a 
virtual volume without any restriction. On the 
other hand, virtual volumes must be of valid 
size and type (i.e., SIZE=280.B for T=D, T=C, 
T=3, and SIZE<=280.B for T=P) to become real 
volumes at the destination. 


Remote transfers cannot take place unless the 
sending FTS provides an ID name that matches 
that of the receiving FTS. These ID names are 
included in appropriate command lines used by 
the FTS stations. The matching ID requirement 
insures that a remote station can not gain 
unwarranted write access to the file server disk 
of the receiving FTS station. Chapter 4 provides 
complete instructions for use of matching ID's. 
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Chapter 2 


Installation 


2.0 Installation 


See the appropriate appendix for specific 
details of modem installation. 


2.1 Network Apple // FTS Installation 


Installation of the File Transfer Server for a 
networked Apple // is described in the following 
sections. Briefly, the installation consists 
of: 


l. Making a backup copy of the distribution 
diskette. 


2. Preparing your modem for use with FTS. 


3. Creating and transferring files to a virtual 
volume for FTS files. 


4. Creating and transferring a file to a virtual 
volume for the import and export of files 
over FTS. 


5. If necessary, modifying the telephone number 
in the FTS Command File so that FTS will dial 
properly. 


6. Testing your File Transfer Server by 
executing the FTS Command File included with 
the system. 


7. Modifying the FTS Command File to conform to 
your needs. 
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2.1.1 Installation Requirements 


To install the networked Apple // File Transfer 
Server, you will need: 


1. An Apple // connected to a network that has 
the Pascal shared library package installed. 


2. A 5.25" floppy diskette drive attached to 
your Apple, with its cable connected to 
"DRIVE 1" of the controller card, and the 
controller card in slot 4 of the Apple. 


3. One of the modems supported by Apple // FTS. 
(See the appendices). 


4. The FTS diskette labelled according to the 
modem you have. Examples of FTS diskette 
names: 


“N2MICRO" 
"N2CAT" 
"N20WL" 


NOTE: Hereafter, your FTS diskette shall be 


referred to as “N2 . 

5. One blank 5.25" floppy diskette. 

6. Access to a telephone line. Please see the 
User’s Manual for your modem for 
specifications regarding touch-tone vs. pulse 
dialing, etc. 

After installation, you will have: 

1. The same Apple // (now elevated to the status 


of File Transfer Server), with a modem 
connected to it, and a telephone line 
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trailing out of the moden.. 


2. Two backup FTS diskettes, both named 
"N2 ae 


3. Virtual volume /MAIN/SYSTEM/FTS, containing 
your FTS code file,-command file and log 
file. 


4, Virtual volume /MAIN/SYSTEM/FTSTEST, 
containing test Pascal text files. 


2.1.2 Contents of the Nestar Distributed Diskette 


The File Transfer Server is shipped on one 5.25" 
floppy diskette, labelled "N2 ". (The "N2" 
stands for Networked version, Apple //; the 
blanks depend upon your modem.) This diskette, 
when transferred to a virtual volume, is a 
bootable Pascal volume. 





Diskette N2 
STARTCMD. TEXT 

Sets the date, then chains to FTS code eile. 
FTSN2 «CODE 


the File Transfer Server code file specific 
to your particular modem. 


FTSCMD. TEXT 


Causes FTS to call your support 
organization and to send it TESTSEND.TEXT 
and receiving to TESTRECV.TEXT. 
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FTSLOG. TEXT 


50-block log file; initially blank. 


TESTSEND. TEXT 


Test Pascal text file sent to your support 
organization by FTS during test run. 


2.1.3 Installation Instructions 


Make a copy of the FTS diskette. 


l; 


Find a blank (or dispensible) diskette. 
Insert it into the disk drive attached to 
your Apple in slot 4, drive 1. 


Boot your Apple // into the Pascal operating 
system. X(ecute PASCAL.CMD. 


Type "SET DRIVE 9 REAL” so that the Apple 
will communicate with the floppy diskette 
drive. 


Type Q<RETURN> to return to the Command 
Level. X(ecute PASCAL:FORMATTER. To the 
prompt “FORMAT WHICH DISK (4, 5, 9..12)?" 
answer "9". After formatting, the prompt will 
appear again. Simply press RETURN this time. 
You will return automatically to the Command 
Level. 


Remove the just-formatted diskette (referred 
to by the Apple as “BLANK:") from the drive, 
and insert the distribution diskette. 


Select the Feiler, and T(ransfer "N2 7 
to "“BLANK:". (Be sure to substitute the name 
of your diskette for "N2 :".) Answer "Y" 
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to the prompts “Transfer 280 blocks?” and 
“Destroy BLANK?”. The Apple will now direct 
you to do a lot of diskette swapping. It 
will take a while, but eventually you will 
return to the F(iler. 


7. Put the diskette away as a backup. Use the 
diskette you have just made for all 
subsequent steps requiring a diskette. 


Prepare your modem for use with the File 
Transfer Server. Please refer to the 
appropriate appendix of this manual for 
instructions. 


Make a Virtual Volume for FTS. 


8. If you have not already done so, Q(uit the 
F(iler to return to the Command Level. 
X(ecute PASCAL:CMD. 


9. Create a virtual volume for your File 
Tranfser Server by issuing this command: 


CREATE /MAIN/SYSTEM/FTS,T=P, SIZE=280.B,RW,D11 


NOTE: If you desire a larger volume, simply 
specify a larger size when using the CREATE 
command. 


10. Issue the command "SET DRIVE 11 VIRT". Type 
Q<RETURN> to return to the command level. 
Select the F(iler. 


ll. Z(ero the volume just created (in device 
#11). Name it FTSVIRT. We recommend that 
you call this volume FTSVIRT rather than 
simply FTS in order to avoid confusion with 
other FTS volumes. 


3/1/83 2-5 


INSTALLATION 


12. With your FTS floppy diskette in the disk 


drive, T(ransfer "#9:=" to “FTSVIRT:S". 
Use of the wild cards in this way will cause 
all of the files from N2 to be 


transferred to FTSVIRT. 


13. R(emove the file "FTSVIRT:TESTSEND.TEXT”. 
Answer "Y" to "UPDATE DIRECTORY?" 


14. Q(uit the F(iler, returning to the Command 
level. 


Create a virtual volume for the import and 
export of files over FTS. 


15. X(ecute PASCAL:CMD. 


16. Make a new volume for holding import and 
export files by typing 


CREATE /MAIN/SYSTEM/FTSTEST, T=P,SIZE=280.B,RW,D11 
(This command will cause FTSVIRT to be 
unmounted, but that volume’s presence is not 


required for this step.) 


17. Return to the Command Level by typing 
Q<RETURN>, then enter the F(iler. 


18. Z(ero the volume just created (in device 
#11:). Name it FTSTEST. 


19. T(ransfer “#9:TESTSEND.TEXT"” to "“FTSTEST:$". 
Q(uit the F(iler, returning to the Command 
Level. 

20. Store diskette N2 - You will no longer 
need any FTS floppy diskettes (except for 


backup purposes). 


If necessary, edit the telephone number in file 
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FTSVIRT:FTSCMD.TEXT . 


21. 


The telephone number included in the test 
FISCMD.TEXT file is the number of your 
support organization. If your installation 
is in a telephone area where this number 
will not work, you will have to edit the 


telephone number in the file 
FTSVIRT:FTSCMD.TEXT in order to reach your 
support organization on your test run. 


Otherwise, proceed to step 22. 


a. Mount /MAIN/SYSTEM/FTS. To do so, X(ecute 
PASCAL:CMD. Then type 


MOUNT /MAIN/SYSTEM/FTS ,D11,RW 
Then type: 

SET DRIVE 11 VIRTUAL 
Next type Q<RETURN> 
to return to the Pascal Command line. 

be Select E(dit. When prompted for the name 
of the file to be edited, type 
“FTSVIRT:FTSCMD.TEXT”. 

c. Press RETURN until the cursor is at the 
line with the phone number to be 
changed. 

SITE XXXX IS PHONE YYYYYYY; 

d. Insert or delete as required. Make sure 

the semicolon remains at the end of the 


line. 


e. Q(uit the E(ditor, S(aving the file with 
the same name. You will be asked whether 
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to delete the old version of 
FTISVIRT:FTSCMD.TEXT before the save; 
respond "Y". E(xit to the Command Level. 


Test your File Transfer Server. 
22. Reboot your Apple //. 


23. When the “VOLUME TO BOOT:" line appears, 
press CONTROL-X to remove the profiled boot 
volume. Substitute /MAIN/SYSTEM/FTS, and 
press RETURN. 


24. The File Transfer Server should now operate 
automatically. First, it displays the 
following banner and messages: 


BAAR Welcome to the RERKK 
&kKKKKK File Transfer Server KARKAA 


Todays date is: 27-May-1984 15:23 
chaining to File Transfer Server Program 


The screen will now clear as FTS executes: 


kkkkkkkškkkšxškškkkkkkkkkkkkkkkkšěkkkkkkkkk 


File Transfer Server 
Version X.X 
Copyright 1981, 1982, 1983 

Nestar Systems, Inc. 


eee ee E a 
ee ee OF 


kkkkkxkkkkkkkkkkkkkkkkkkkkkkkkkkkkěkkkk 


FTS initializes your new log file as described 
in Chapter 3. 


Uninitialized or damaged file; initializing it 


Initialized 50 blocks 
Logging to file FTSLOG.TEXT, 
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size is 50 blocks 


FTS will now give you ten seconds to change the 
command file from FTSVIRT:FTSCMD. Do not press 
the spacebar; allow FTS to proceed. The 
following appears on the screen: 


Press the spacebar to change 
command file from FTSCMD.TEXT 


FTS will auto-start in 10 seconds... 
Reading FTSVIRT:FTSCMD.TEXT 


The file FTSVIRT:FTSCMD.TEXT will be displayed 
on your screen line by line as FTS compiles it. 
At the end FTS should print 


---no errors detected--- 
Memory available = 


Finding no errors, FTS will now commence 


execution of the command file. The following 
will appear on the screen: 
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Doing "DEMOPROC" 

MOUNT /MAIN/SYSTEM/FTSTEST,D11,RO,UPD 
Dialing: X-XXX-XXX-XXXX 

Waiting for phone to be answered... . 
Answered 

Answering version is X.X 

Opening TESTSEND.TEXT 

Sending block 0 

Sending block 1 

Sending block 2 

Sending block 3 

Creating file TESTRECV.TEXT 

block O received. 

block 1 received. 

block 2 received. 

block 3 received. 


Hanging up the phone at XX:XX:XX 
Waiting to do “DEMOPROC" in 178 minutes 
XX: XX: XX 


25. If all has gone well, your File Transfer 
Server will now wait for another three hours 
to do "“DEMOPROC" again; you should stop it 
before it does. If all has not gone well, 
FTS will execute the RETRY instruction, and 
wait only 5 minutes before attempting 
“DEMOPROC™ again. If the retrial of 
"DEMOPROC" fails, try rebooting as 
described above. 


26. Press <escape>-Q-<RETURN> Y <RETURN> to 
abort operation of the File Transfer 


Server. Enter the F(iler, and select 
T(ransfer. When prompted for what file to 
transfer, type 


"FTSTEST: TESTRECV.TEXT,CONSOLE:". This will 
cause the contents of the test-receiver file 
to be displayed on your screen, so you can 
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verify that FTS has worked properly. 


Modify FTSCMD.TEXT to conform to your needs. As 
it now stands, your File Transfer Server is 
prepared to call your support organization 
whenever you boot it. In order for your FTS to 
do anything else, you will have to give it a new 
Command File. We recommend that you do this by 
altering the FTSCMD.TEXT that you transferred to 
/MAIN/SYSTEM/FTS from the diskette; this will 
help you avoid syntax errors. 


27. Q(uit the F(iler, returning to the Command 
Level. Select the E(ditor. When asked for 
the name of the file to be edited, type 
“FTSCMD". 


28. Edit the file to your needs (see Section 6 
of this manual). Save the file with the 
same name when finished. 


Test the new FTSCMD.TEXT. 


29. Start up your File Transfer Sever by 
rebooting the Apple //, again using 
CONTROL-X to substitute /MAIN/SYSTEM/FTS for 
the profiled boot volume. FTS will now 
process the commands you have just put into 
the file FTSVIRT:FTSCMD.TEXT . 


2.2 Standalone Apple // FTS Installation 
Installation of the File Transfer Server for 
standalone Apple // is described in the 
following sections. Briefly, the installation 
consists of: 

l. Making a backup copy of the distribution 


diskette. 
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Installing and initializing your Nestar 
Clock-Calendar Card. 


Preparing your modem for use with FTS. 


` If necessary, modifying the telephone number 


in the FTS Command File so that FTS will dial 
properly. 


Testing your File Transfer Server by 
executing the FTS Command File included on 
the distribution diskette. 


6. Modifying the FTS Command File to conform 
to your needs. 


2.2.1 Installation Requirements 


To 


install the stand-alone Apple // File 


Transfer Server, you will need: 


Ls 


26 


A 64k Apple //. 


Two 5.25" floppy diskette drives, attached to 
the same disk controller card, with the 
controller card in slot 6 of the Apple. 


One of the Apple // - compatible modems 
supported by FTS. 


The FTS package, which consists of: 


a. A 5.25" diskette, labelled according to 
the modem you have. For example, 
"S2MICRO", "S2CAT", or “S2OWL". (NOTE: 
Hereafter, the FTS diskette you are 
installing shall be referred to as 
"52 "e) 
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b. A Nestar Clock-Calendar Card. 


5. A bootable Pascal diskette from which you can 
go into the E(ditor, such as “APPLE1:" from 
Apple. For the sake of brevity, we shall 
refer to this diskette simply as "APPLE1:". 


6. A Pascal diskette containing the’ file 
FORMATTER.CODE, such as “APPLE3:" from Apple. 
Again, for brevity’s sake, we shall refer to 
this diskette simply as “APPLE3:" (bearing in 
mind that any diskette containing 
FORMATTER.CODE will do equally well). 


7. One blank 5.25" floppy diskette. 


8. Access to an ordinary telephone line. Please 
see the Users Manual for your modem for 
specifications regarding touch-tone vs pulse 
dialing, etc. 


After installation, you will have: 


1. The same Apple // (now elevated to the status 
of File Transfer Server), with the Nestar 
Clock-Calendar Card installed, a modem 
connected, and a telephone line trailing out 
of the modem. 


2. A backup FTS diskette, named "S2 ae 


3. A bootable FTS diskette, also named 
"$2 tae 





2.2.2 Contents of the Distribution Diskette 


The File Transfer Server is shipped on one 5.25" 
floppy diskette, labelled "S2 "a (The “S2" 
stands for Standalone version, Apple //; the 
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blanks depend upon your modem.) This diskette 
is a bootable Pascal volume. 
Diskette $2 
SYSTEM. STARTUP 
a/k/a FTSS2 -CODE. The File Transfer 


Server code file specific to your 
particular modem. 





FTSCMD. TEXT 
Causes FTS to call your support 
organization, sending TESTSEND.TEXT and 
receiving to TESTRECV.TEXT. 
FTSLOG. TEXT 
50-block log file; initially blank. 
TESTSEND. TEXT 


Test Pascal text file sent to your support 
organization by FTS during test run. 


SETCLOCK. CODE 


Sets the time and date on the 
Clock-Calendar Card. 


SYSTEM. APPLE } 

SYSTEM. PASCAL }Needed for successful 
SYSTEM.MISCINFO juse. of Pascal operating 
SYSTEM. LIBRARY }system 


2.2.3 Installation Instructions 


Make a copy of the FTS diskette. 
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Boot your Apple //, after inserting the 
APPLE1: diskette (see item 5 of INSTALLATION 
REQUIREMENTS) in drive 4 (that is, the drive 
connected to the port on the disk controller 
card labelled “DRIVE 1"). 


Insert the APPLE3: diskette (see item 6 of 
INSTALLATION REQUIREMENTS) in drive 4. Insert 
your blank/dispensible diskette in drive 5 
(that is, the drive connected to the port on 
the controller card labelled "DRIVE 2"). 


X(ecute #4:FORMATTER . To the prompt "FORMAT 
WHICH DISK (4, 5, 9..12)?" answer "5". After 
formatting, the prompt will appear again. 
Simply press RETURN this time. 


Exchange the APPLE1: diskette for the APPLE3: 
diskette that is presently in drive 4. Select 
the F(iler, then exchange the distribution 
diskette (labelled "S2 ") for "Apple 1" 
in drive 4. 


Select T(ransfer. To the prompt "Transfer?", 
respond "#4:,#5:". This will cause everything 
on the distribution diskette to be 
transferred to your blank diskette. Answer 
"Y" to the prompts "Transfer 280 blocks?” and 
“Destroy BLANK?". 


Put the diskette away as a backup. Use the 
diskette you have just made for all 
subsequent steps requiring an FTS diskette. 


Install and initialize your Nestar 
Clock-Calendar Card. 


Please refer to Appendix B of this manual 
for instructions regarding this card. 
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Prepare your modem for use with the File 
Transfer Server. 


Please refer to the appropriate appendix of 
this manual for instructions. 


If necessary, edit the telephone number in file 
FTSCMD.TEXT: 


7. The telephone number included in the test 
FTSCMD. TEXT file is the number of your 
support organization. If your installation is 
in a telephone area where this number will 
not work, then you will have to edit the 
telephone number in the file 
$2 :FTSCMD.TEXT in order to reach your 
support organization on your test run. 
Otherwise, proceed to step 8. 





a. Reinsert the APPLE1: diskette in drive 4. 
If you have not already done so, Q(uit the 
F(iler to return to the Command Level. 


b.e Select E(dit. When prompted for the name 
of the file to be edited, type 
“#5: FTSCMD.TEXT". 


c». Press RETURN until the cursor is at the 
line with the phone number to be changed. 


SITE XXXXX IS PHONE YYYYYYY; 


d. Insert or delete as required. Make sure 
the semicolon remains at the end of the 
line. 


e. Q(uit the E(ditor, S(aving the file with 
the same name. You will be asked whether 
to purge the old version of #5:FTSCMD.TEXT 
before the save; respond "Y". E(xit to the 
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Command Level. 


Test Your File Transfer Server 


8. Reboot your Apple // with your copy of the 
FTS diskette S2 in drive 4. 


9. The File Transfer Server should now operate 
automatically. First, it displays the 
following banner and messages: 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


File Transfer Server 
Version X.X 
Copyright 1981, 1982, 1983 

Nestar Systems, Inc. 


+ FF FF FE 
+ + + + EF 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


Next, FTS initializes your new log file, as 
described in Chapter 3. i 


Uninitialized or damaged file; reinitializing it 
Initialized 6 blocks 

Logging to file FTSLOG.TEXT, 
size is 6 blocks 


FTS will now give you ten seconds to change the 
command file from FTSCMD. Do not press the 
spacebar; allow FTS to proceed. The following 
appears on the screen: 


Press the spacebar to change 
command file from FTSCMD.TEXT 


FTS will auto-start in 10 seconds... 
Reading FTSCMD.TEXT 


The file FTSCMD.TEXT will be displayed on your 
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screen line-by-line as FTS compiles it. At the 
end FTS should print 


---No errors detected--- 
Memory available = 


Finding no errors, FTS will now commence 
execution of the command file, displaying 
the following messages: 


Doing "“DEMOPROC" 

Dialing X-XXX-XXX-XXXX 
Waiting for phone to be answered .. à 
Answered 

Answering version is X.X 
Opening #4: TESTSEND. TEXT 
Sending block 0 

Sending block 1 

Sending block 2 

Sending block 3 

Creating file #4:TESTRECV.TEXT 
Block 0 received. 

Block 1 received. 

Block 2 received. 

Block 3 received. 


Hanging up the phone at XX:XX:XX 
Waiting to do "DEMOPROC" in 178 minutes 
XX: XX: XX 


10. If all has gone well, your File Transfer 
Server will now wait for another three hours 
to do "DEMOPROC” again; you-should stop it 
before it does. If all has not gone well, 
FTS will execute the RETRY instruction, and 
wait only 5 minutes before attempting 
“DEMOPROC"™ again. If the retrial of 
“DEMOPROC"™ fails, try rebooting as 
described above. 
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ll. Press <escape>-Q-RETURN-Y-RETURN to abort 
operation of the File Transfer Server. 
(Depending on your Apple, you may have to 
press <escape> twice before FTS will accept 
the Q-RETURN.) 


12. Insert diskette “Apple 1" in drive 5. Enter 
the F(iler, and select T(ransfer. 


13. When prompted for what file to transfer, 
type "#4:TESTRECV.TEXT,CONSOLE:". This will 
cause the contents of the test-receiver file 
to be displayed on your screen, so you can 
verify that FTS has worked properly. 


Modify FTSCMD.TEXT to conform to your needs. 


As it now stands, your File Transfer Server is 
prepared to call your support organization 
whenever you boot it. In order for your FTS to 
do anything else, you will have to give it a new 
Command File. We recommend that you accomplish 
this by altering the FTSCMD.TEXT that is already 
on your FTS diskette; this will help you avoid 
syntax errors: 


14. Q(uit the F(iler, returning to the Command 
Level. Select the E(ditor. : 


15. When asked for the name of the file to be 
edited, type “#4:FTSCMD”. 


16. Edit the file to your needs (see Section 6 


of this manual). Save the file with the 
same name when finished. 


Test the new FTSCMD.TEXT. 


17. Start up your File Transfer Server by 
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rebooting the Apple // with your FTS 
diskette in drive 4. FTS will now process 


the commands you have just put into the file 
FTSCMD. TEXT. 


2.3 Network Apple /// FTS Installation 
Installation of the File Transfer Server is 
described in the following sections. Briefly, 


the installation consists of: 


l. Making a backup of the distribution 
diskette. 


2. Preparing your modem for use with FTS. 


3. Creating and transferring files to a virtual 
volume for FTS files. 


4. Creating and transferring a file to a virtual 
volume for the import and export of files 
over FTS. 


5. If necessary, modifying the telephone number 
in the FTS Command File so that FTS will dial 
properly. 

6. Testing your File Transfer Server by 
executing the FTS Command File included on 
the distribution diskette. 

7. Modifying the FTS Command File to conform to 
your needs. 


2.3.1 Installation Requirements 


To install the File Transfer Server, you will 
need: 
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An Apple /// connected to a network that has 
had the SoS shared library package 
installed. . 


One of the modems supported by the Apple /// 
FTS package (see appendices B-G). 


The FTS package, which consists of: 
a) An RS-232C cable 


b) Two 5.25" floppy diskettes labeled 
according to the modem being used. Examples 
of label contents are: 


N3SMART.1 
N3SMART.2 
N3SM12.1 
N3SM12.2 


‘Note: Hereafter, your FTS diskettes shall be 


referred to as "N3----- wa” and N3----- oe i's 


The diskette from Apple (which was included 
with your -Apple ///) labeled “System 
Utilities.” 


A Pascal boot diskette, with network drivers, 
whose STARTCMD file causes the virtual volume 
/MAIN/SOS/LIB to be mounted on some virtual 
drive. (See the Network File Server Users 
Manual. : 


Two blank 5.25" floppy diskettes. 


Access to an ordinary telephone line. 


After installation, you will have: 


l. 


The same Apple /// (now elevated to the 
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status of File Transfer Server), with a modem 
connected to it, and a telephone line 
trailing out of the modem. 


2. The unaltered System Utilities and Pascal 
boot diskettes. 


3. Backup diskettes N3----- -l and N3----- i, 
4. Boot diskette FTSREAL. 


5. Virtual volume /MAIN/SYSTEM/FTS3, containing 
your FTS code file, command file and log 
file. 


6. Virtual volume /MAIN/SYSTEM/FTSTEST3, 
containing test text files. 


2.3.2 Contents of the Distribution Diskettes 


The File Transfer Server is shipped on two 5.25" 
floppy diskettes, labelled according to the 
modem driver being used: N3----- el and 
N3----- ere (The N3 in these names stands for 
Apple ///, Networked version.) The first of 
these diskettes is a bootable SOS-Pascal 
diskette; the second contains files which are 


transferred to virtual volumes during 
installation. M 

Diskette N3----- ol 

SYSTEM. STARTUP 


a/k/a NESTAR.START; causes contents of 
STARTCMD.TEXT to be processed. 
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STARTCMD . TEXT 


Mounts /MAIN/SOS/LIB and /MAIN/SYSTEM/FTS3, 
then chains automatically to FTS program. 


SYSTEM.LIBRARY 


Minimal SOs library required by 
NESTAR.START. 


DEFAULTS. TEXT 

Sets FTSCMD and FTSLOG to volume FTSVIRT. 
SOS.DRIVER 

Contains drivers for the network, the 


modem, and for one 5.25" drive in addition 
to the Apple’s built-in drive. 


SOS. KERNEL } 

SOS.INTERP }Needed to successfully 
SYSTEM. PASCAL }use the Pascal operating 
SYSTEM.MISCINFO } system. 

Diskette N3----- 2 


FTSN3---. CODE 
The File Transfer Server Software. 
FTSCMD. TEXT 


Calls your support organization; sends 
TESTSEND; receives to TESTRECV. 


FTSLOG. TEXT 
50-block circular log file; initially 


blank. 
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TESTSEND. TEXT 


Test Pascal text file sent to your support 
organization by FTS during test run. 


2.3.3 Installation Instructions 
Make Copies of The FTS Disketttes 


We recommend that you use the System Utilities 
diskette from Apple in order to do this: 


1. Boot your Apple /// with the System Utilities 
diskette in the built-in drive. 


2. Select "D" (Device handling commands), then 
"C" (Copy volumes). 


3. Remove the System Utilities diskette from the 
built-in drive, replacing it with the first 
FTS diskette (labelled N3----- al) 


4. Have ready one of the two diskettes you wish 


to become your copies. Make sure the 
diskette’s write-protect notch is not 
covered. (Note: This diskette can have 


anything on it, to begin with. The COPY 
utility will wipe everything off the 
diskette, reformatting it if necessary.) 


5. Respond to these prompts as follows: 


PROMPT: RESPONSE: 


Copy the volume -D1 

to the volume «D1 

with new volume name FTSREAL 

destroy old XXXXX? Y (may not appear) 


Your Apple will now direct you to swap 
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diskettes until the copy is complete. (The 
source diskette is N3----- el and the 
destination diskette is a blank floppy. The 
blank floppy will become your usable FTS 
volume. 


6. Put the source N3----- .l diskette away as a 
backup. Use the diskette you just made for 
all further FTS operations. 


7. Put the second diskette (labelled N3----- a 
into the disk drive. Repeat steps 5 and 6, 
copying onto a different diskette, with new 
volume name "“FTS2". 


8. Write-protect the disks FTSREAL and FTS2 by 
affixing stickers over the write-protect 
notches. 


Prepare Modem For Use With The File Transfer 
Server 


(See Appendix F or G) 


Create a Virtual Volume For Your FTS Files 


NOTE: The following assumes that the SOS shared 
library software (A-2831) has been installed on 
your system. You will need a Pascal boot 
diskette whose STARTCMD file causes 
/MAIN/SOS/LIB to be mounted. (Instructions for 
creating such a diskette are found in Chapter 9 
of the Network File Server User’s Manual.) 


9. Boot your Apple /// with the aforementioned 
Pascal boot diskette in the main disk drive. 


10. From the Command Level, X(ecute /LIB/CMD. 
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ll. In order to prevent the unmounting of 
/MAIN/SOS/LIB by the next step, remount the 
/MAIN/SOS/LIB by issuing this command: 

MOUNT /MAIN/SOS/LIB,D2 


12. Create a virtual volume for your File 
Transfer Server by typing 


CREATE /MAIN/SYSTEM/FTS3,T=3,SIZE=280.B,RW,D1 


13. Return to the Command Level (by typing 
Q-RETURN), and then X(ecute /LIB/UTILS. 


14. Select "D" (Device handling commands), then 
"Cc" (Copy volumes"). 


15. Insert your diskette "FTS2" into the Apple’s 
` built-in disk drive. 


16. Respond to these prompts as follows: 


PROMPT: RESPONSE: 
Copy the volume D1 
to the volume N1 
with new volume name FTSVIRT3 


17. Press <escape> twice to return to the main 
menu. Select "F" (File handling commands), 
then "D" (Delete files). 


18. Delete /FTSVIRT3/TESTSEND.TEXT . Respond "Y" 
to "UPDATE DIRECTORY?” 

Test the New FTSCMD. 

Start up your File Transfer Server by rebooting 

the Apple with usable diskette FTSREAL in the 


main drive. FTS will now process the commands 
you have just put into the file 
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/FTSVIRT3/FTSCMD.TEXT. 


Create A Virtual Volume For The Import And 
Export Of Files Over FTS: 


19. From the command level, X(ecute /LIB/CMD. 


20. Create a virtual volume for testing FTS by 
typing 


CREATE /MAIN/SYSTEM/FTSTEST3,T=3,SIZE=280.B, 
RW,D1 (Type on one line only) 


(This will cause FTSVIRT3 to be unmounted, but 
we do not need FTSVIRT3 for this step. 


21. Return to the command level (by typing 
Q-RETURN). X(ecute /LIB/UTILS. 


22. Select "D" (Device handling commands), then 
"F" (Format a volume). Format the volume in 
device .Nl with the volume name "FTSTEST3”. 


23. Press <escape> twice, then select "F" (File 
handling commands) and "C" (Copy files). 


24. Make sure diskette FTS2 is in the Apple’s 
built-in drive. 


25. Copy .D1/TESTSEND.TEXT to /FTSTEST3/$. This 
will create a file TESTSEND. TEXT on 
FTSTEST3. 


26. Store diskette FTS2 as a backup. If 
necessary, edit the telephone number in file 
/FTSVIRT3/FTSCMD. TEXT: 


27. The telephone number included in the test 
FTSCMD.TEXT file is the number of your 
support organization. If your installation 
is in a telephone area where this number 
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will not work, you will have to edit the 
telephone number in the file 
/FTSVIRT3/FTSCMD.TEXT in order to reach your 
support organization on your test run. 
Otherwise, proceed to step 28. 


a. Reinsert your Pascal boot diskette in the 
Apples built-in drive. Press <escape> 
twice, then Q, to return to the Pascal 
Command Level. 


b. Select E(dit. When prompted for the name 
of the file to be edited, type 
"/FTSVIRT3/FTSCMD. TEXT". 


c. Press RETURN until the cursor is.at the 
line with the: phone number to be 
changed. 


SITE XXXXX IS PHONE YYYYYYY; 


d. Insert or delete as required. Make sure 
the semicolon remains at the end of the 
line. 


e. Q(uit the E(ditor, S(aving the file with 
the name /FTSVIRT3/FTSCMD.TEXT. You will 
be asked whether to delete the old 
version of /FTSVIRT3/FTSCMD.TEXT before 
the save; respond "Y". E(xit to the 
command level. 


Test your File Transfer Server. 


28. 


29. 


30. 


2-28 


Insert diskette “FTSREAL" in your 
Apple ///“s disk drive. 


Boot your Apple. 


The File Transfer Server should now operate 
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automatically. The following banner and 
messages will be displayed. 


FERRER Welcome to the KARRAR 
kkKKKK File Transfer Server! ****x** 


First, some internal housekeeping: 


mounting FTS virtual volume. . . 
mounting SOS library volume. . 
chaining to File Transfer Server Program. . 


‘The screen will now clear as FTS executes: 


KKKKKKKKKKKKEKREREREEKRREERKERKKKKERERKKR 


File Transfer Server 
Version X.X 
Copyright 1981, 1982, 1983 

Nestar Systems, Inc. 


ee Fe FF 
ee F HF FF 


KKAKKKKKKKKKKEKKEKKEKKERREREREREKERKEEERER 


log file changed to 
/FTSVIRT3/FTSLOG.TEXT by defaults file 

command file changed to 
/FTSVIRT3/FTSCMD.TEXT by defaults file 


Then, FTS initializes your new log file, as 
described in Chapter 3. 


Uninitialized or damaged file; initializing it 
Initialized 50 blocks 
Logging to file /FTSVIRT3/FTSLOG.TEXT, 

size is 50 blocks 


FTS will now give you ten seconds to change the 
command file from /FTSVIRT3/FTSCMD. Dò not 
press the spacebar; allow FTS to proceed. The 
following appears on the screen: 
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Press the spacebar to change 
command file from FTSCMD.TEXT 


FTS will auto-start in 10 seconds... 
Reading /FTSVIRT3/FTSCMD. TEXT 


The file /FTSVIRT3/FTSCMD.TEXT will be displayed 
on your screen line-by-line as FTS compiles it. 
At the end FTS should print 


---No errors detected--- 
Memory available = 


The amount of memory available will be on the 
order of tens of thousands of bytes. Finding no 
errors, FTS will now commence execution of the 
command file and display the following 
messages: 


Doing “DEMOPROC" 

MOUNT /MAIN/SYSTEM/FTSTEST3,d3,RO,UPD 
Dialing: X-XXX-XXX-XXXX 

Waiting for phone to be answered... 
Answered 

Answering version X.X 

Opening TESTSEND.Text 

Sending block 0 

Sending block 1 

Sending block 2 

Sending block 3 

Creating file TESTRECV.Text 

Block O received. 

Block 1 received. 

Block 2 received. 

Block 3 received. 


Hanging up the phone at XX:XX:XX 


Waiting to do "DEMOPROC” in 178 minutes 
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XX: XX2 XX 


31. If all has gone well, your File Transfer 
Server will now wait for another three hours 
to do “DEMOPROC" again; you should stop it 
before it does. If all has not gone well, 
FTS will execute the RETRY instruction, and 
wait only 5 minutes before attempting 
“DEMOPROC" again. If the retrial of 
“DEMOPROC" fails, try rebooting with FTSREAL 
in the built-in drive. 


32. Press <Escape>—Q-<RETURN>-Y—-<RETURN> to 
abort operation of the File Transfer 


Server. Enter the F(iler, and select 
T(ransfer. When prompted for what file to 
transfer, type 
"/FTSTEST3/TESTRECV. TEXT ,CONSOLE:". This 


will cause the contents of the test-receiver 
file to be displayed on your screen, so you 
can verify that FTS has worked properly. 


Modify FTSCMD.TEXT to conform to your needs. 


As it now stands, your File Transfer Server is 
prepared to call your support organization 
whenever you boot it. In order for your FTS to 
do anything else, you will have to give it a new 
Command File. We recommend that you accomplish 
this by altering the syntax errors: 


33. Press <escape>, Q, then Y to abort operation 
of the File Transfer Server. This returns 
you to the Command Level. 

34. Select the E(ditor. When asked for the name 
of the file to be edited, type 
"/FTSVIRT3/FTSCMD.TEXT”. 


35. Edit the file to your needs (see Section 6 
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of this manual). Save the file with the same 
. Mame when finished. 


Test the new FTSCMD 

36. Start up your File Transfer Server by 
rebooting the Apple with the usable diskette 
FTSREAL in the main drive. FTS will now 
process the commands you have just put into 
the file /FTSVIRT3/FTSCMD. TEXT. 

2.4 Standalone Apple /// FTS Installation 

Installation of the standalone File Transfer 

Server is described in the following sections. 

Briefly, the installation consists of: 

l. Making a copy of the distribution diskette. 

2. Preparing your modem for use with FTS. 

3. If necessary, modifying the telephone number 
in the FTS Command File so that FTS will dial 
properly. 

4. Testing your File Transfer Server by 
executing the FTS Command File included with 
the system. 

5. Modifying the FTS Command File to conform to 
your needs. 


2.4.1 Installation Requirements 


To install the standalone File Transfer Server, 
you will need: 


1. An Apple ///. 
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2. One of the modems supported by the Apple /// 
FTS package. (See the appendices). 


3. The FTS package, which consists of: 
a. A 5.25" floppy diskette labelled according 
to the modem being used. Possible label 


contents are: 


S3SMART 
$3SM12 


Note: Hereafter, your FTS diskette shall 
be referred to as "S3----- 


b. An RS-232C cable. 
4. The SOS diskette from Apple (which was 
included with your Apple ///) labelled 


“System Utilities." 


5. A Pascal boot diskette, from which you may 
gain access to the E(ditor. 


6. One blank 5.25” floppy diskette. 


7. Access to an ordinary telephone line. 


After installation, you will have: 

l. The same Apple /// (now elevated to the 
status of File Transfer Server), with a modem 
connected to it, and a telephone line 


trailing out of the modem. 


2. The unaltered System Utilities and Pascal 
boot diskettes. 


3. Backup diskette S3----- . 
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4. Boot diskette FTS. 


2.4.2 Contents of the Distribution Diskette 


The File Transfer Server is shipped on one 5.25" 
floppy diskette, labelled S3----- e (The "S3" in 
these names stands for Apple ///, Standalone 
version.) This diskette is a bootable SOS-Pascal 
diskette; the FTS code file has been renamed 
*SYSTEM. STARTUP so that it will execute 
automatically when the volume is booted. (File 
names preceded with * are write-protected.) 


Diskette S3---: 


*SYSTEM.STARTUP aka FTSS3---.CODE the 
File Transfer Server 
software 

FTSCMD. TEXT Calls your support 


organization and sends it a 
file called TESTSEND; then 
it receives a file called 
TESTRECV. 


FTSLOG. TEXT 6-block circular log file; 
initially blank. 


TESTSEND.ASCI Test SOS ascii file sent 
to your support organization 
during test run. 


*SYSTEM. LIBRARY Minimal SOS library required 
by FTS. 
*SOS.DRIVER Contains drivers for RS-232, 


the built-in 5.25" floppy 
disk and one additional 
5.25" floppy disk. 
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*SOS.KERNEL } 

*SOS.INTERP } Needed to boot the 

* SYSTEM. PASCAL } Apple /// into Pascal. 
*SYSTEM.MISCINFO } 


2.4.3 Installation Instructions 
Make a copy of the distribution diskette: 


The File Transfer Server writes to a file called 
FTSLOG.TEXT on the FTS diskette. Since the FTS 
distribution diskette is write-protected, you 
must copy its contents onto another, 
non-protected diskette. We recommend that you 
use the System Utilities diskette from Apple in 
order to do this. 


l. Boot your Apple /// with the System Utilities 
diskette in the built-in drive. 


2. Press D ("Device handling commands”), then C 
(“Copy”). 


3. Replace the System Utilities diskette in the 
main drive with the "S3---" diskette. 


4, Have ready the diskette you want to become 
your usable FTS volume. Make sure that this 
diskette’s write-protect notch is not 
covered. (Note: This diskette can have 
anything on it to begin with, including 
Apple // files. The COPY utility will wipe 
everything off the diskette, reformatting it 
if necessary.) 


5. Respond to these prompts as follows: 
PROMPT: RESPONSE: 


Copy the volume «D1 
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to the volume -D1 

with new volume name FTS 

destroy old XXXXXX? Y (may not appear) pen 
Your Apple will now direct you to swap 
diskettes until the copy is complete. (The 
diskette is the “source volume"; the diskette 

which will become your usable FTS volume is 

the "destination volume”. ) 


6. Put the source diskette (S3----- ) away as a 
backup. Use the diskette you just made 
("FTS") for all further FTS operations. 


Prepare your modem for use with the File 
Transfer Server. ( Refer to Appendix F and G.) 


If necessary, edit the telephone number in file 
/FTS/FTSCMD. TEXT. - 


7. The telephone number included in the test 
FTSCMD.TEXT file is the number of your 
support organization. If your installation 
is in a telephone area where this number will 

“not work, then you will have to edit the 
telephone number in the file /FTS/FTSCMD. TEXT 
in order to reach your support organization 
on your test run. 


a. Insert in your Apple’s built-in disk drive 
a bootable Pascal diskette from which you 
may enter the E(ditor. Boot the Apple. 


b. Select E(dit, then insert diskette "FTS". 
When prompted for the name of the file to 
be edited, type “.D1/FTSCMD.TEXT”. a, 


c. Press RETURN until the cursor is at the 
line with the phone number to change. 
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SITE XXXX IS PHONE YYYYYYY; 


d. Insert or delete as required. Make sure 
the semicolon remains at the end of the 
line. 


e. Q(uit the E(ditor, S(aving the file with 
the same name. You will be asked whether 


to delete the old version of 
/ETS/FTSCMD.TEXT before the save; respond 
ay" e 


Test Your File Transfer Server 


8. Make sure diskette "FTS" is in your 
Apple ///“s built-in disk drive. 


9. Boot your Apple. 


10. The File Transfer Server should now operate 
automatically. It will display the 
following banner and messages: 


kkkkkkkkkkšškkkkkkkkkkkkkkkkkkkkkkkkkk 


File Transfer Server 
Version X.X 
Copyright 1981, 1982, 1983 

Nestar Systems, Inc. 


Xo + Fe 
eee + + 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


Next, FTS initializes your new log file. 
Uninitialized or damaged file; initializing it 
Initialized 6 blocks 
Logging to file FTSLOG.TEXT, 

size is 6 blocks 


FTS will now give you ten seconds to change the 
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command file from /FTS/FTSCMD. Do not press the 
spacebar; allow FTS to proceed. The following 
appears on the screen: 


Press the spacebar to change 
command file from FTSCMD.TEXT 


FTS will auto-start in 10 seconds... 
Reading FTSCMD. TEXT 


The file /FTS/FTSCMD.TEXT will be displayed on 
your screen line-by-line as FTS compiles it. At 
the end FTS should print 


---no errors detected--— 
Memory available = 


Finding no errors, FTS will now commence 
execution of the command file, displaying the 
following messages: 


Doing “DEMOPROC" 

Dialing X-XXX-XXX-XXXX 

Waiting for phone to be answered.... 
Answered 

Answering version is X.X 

Opening .D1/TESTSEND.ASCI 

Sending block 0 

Creating file .D1/TESTRECV.ASCI 
Block 0O received. 


Hanging up the phone at XX:XX:XX 
Waiting to do "DEMOPROC" in 178 minutes 
XX: XX: XX 
ll. If all has gone well, your File Transfer 
Server will now claim that it is waiting 


three hours to do “DEMOPROC" again. Such is 
not the case, however, because there is no 
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clock in your Apple ///. FTS has no way of 
telling how much time has elapsed, so it 
will simply count from O to 59 over and over 
again until you stop it by hitting 
<escape>. (If and when your Apple /// gets 
a clock, this feature will become fully 
operational.) 


12. If all has not gone well (e.g., the line was 
busy at your support organization, or there 
was too much static on the phone line), FTS 
will execute the RETRY instruction, claiming 
to wait 5 minutes before reattempting 
“DEMOPROC". Again, since there is no clock, 
FTS will never count past one minute, and 
the retrial will not take place without user 


intervention. If the first test run of 
“DEMOPROC" fails, you must hand-schedule a 
retrial: 


a. Press <escape> to halt the File Transfer 
Server. 


b. Select S(chedule. Schedule “DEMOPROC". 


ce Select C(ontinue. FTS will now retry 
“DEMOPROC". 


13. Press <Escape>-Q-<RETURN>~-Y—-<RETURN> to 
abort operation of the File Transfer 
Server. 


Enter the F(iler, and select T(ransfer. When 
prompted for what file to transfer, type 
"/FTS/TESTRECV.ASCL,CONSOLE:". This will cause 
the contents of the test-receiver file to be 
displayed on your screen, so you can verify that 
FTS has worked properly. 
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Modify FTSCMD.TEXT to Conform to Your Needs 


As it now stands, your File Transfer Server is 
prepared to call your support organization 
whenever you boot it. In order for your FTS to 
do anything else, you will have to give it a new 
Command File. We recommend that you accomplish 
this by altering the FTSCMD.TEXT on diskette 
"FTS"; this will help you avoid syntax errors. 


14. Boot any Pascal volume which will allow you 
access to the E(ditor. 


15. From the Command Level, go into the 
E(ditor. 


16. Remove the Pascal volume, replacing it with 
your diskette "FTS". 


17. Edit file .D1/FTSCMD.TEXT to your needs (see 
section 6 of this manual). 

Test the new FTSCMD 

18. Reboot the Apple with your diskette "FTS" in 
the built-in drive. FTS will now process 


the commands you have just put into the file 
FTSCMD. TEXT. 
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HOW FTS WORKS 


3.0 Introduction 


FTS is designed to be fully ‘automatic. From 
power up to power down, a dedicated FTS station 
can perform a variety of tasks at specific 
intervals, and repeat these tasks day after day 
without operator intervention. Of course, 
variations from this automatic operation are 
also possible. Operators can interrupt FTS and 
issue commands directly from the keyboard, or, 
hand schedule a previously defined task. Your 
installation may want to use one computer for a 
number of different duties, with FTS only 
running part of the time. Below we explain how 
FTS runs automatically, and how you can 
intervene when necessary. 


3.1 Automatic Startup of FTS 


If your FTS station is an Apple /// that is 
connected to a network, you need to insert and 
boot its 5.25" floppy boot diskette. If you 
have properly followed the installation 
instructions in Chapter 2 of this manual, this 
boot diskette contains the SYSTEM.-STARTUP file 
supplied by Nestar on the FTS distribution 
floppy. This SYSTEM.STARTUP file contains 
instructions that cause the virtual volume 
containing FTS to be mounted and the FTS program 
to be executed automatically for you. 


If your FTS station is an Apple // that is 
connected to a network, its profile record 
called //system/profile/$nn, (nn is stn address) 
can be configured such that the virtual volume 
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containing FTS is booted automatically upon 
system powerup. If the Startcmd.Text file that 
Nestar supplied with your FTS package is on this 
virtual boot volume, the FTS program will be 
executed automatically for you. If your 
Apple // FTS station is not dedicated full time 
to FTS functions, you may want to configure the 
stations’s profile record accordingly. The 
Cluster/One File Server Users Manual describes 
how to do this. 


If your FTS station is a standalone Apple ///, 
you just need to insert and boot your FTS 
diskette. As we explained in Chapter 2, the FTS 
code file has been named SYSTEM.STARTUP so that 
it executes automatically when you boot up -the 
FTS diskette. 


If your FTS station is a standalone Apple //, 
you can start up FTS by inserting and booting 
your FTS diskette. The FTS code file has been 
named SYSTEM.STARTUP so that it executes 
automatically when you boot up the FTS 
diskette. 


Once FTS is running, its operation is 
essentially the same, regardless of which type 
of computer it it is running on. We will point 
out differences when necessary. 


3.2 FTS Prepares to Use the Log and Command 
Files 


When the FTS software is executed, it looks in 
the Defaults.Text file (on the prefix volume) 
for the names of the FTS command and log files 
that you want it to use. The FTS command file 
feeds instructions to FTS, and the log file is 
used by FTS to keep a log of its significant 
activities. Placing names for the log and 
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command files in Defaults.Text is optional. FTS 
will use its defaults for these file names 
(Ftslog.Text and Ftscemd.Text) if it does not 
find them listed in a Defaults.Text file. 


The format of this Defaults.Text file is as 
follows: 


FTS: CMD filename 
FTS: LOG filename 


NOTE: If your FTS program is running on a 
network, the Defaults.Text file may contain 
instructions for other network applications. 
This is why the FTS command file and log file 
names are preceded by "FTS". 


If your Defaults.Text file contains filenames 
without ".Text" at the end, FTS will append the 
".Text" and look on the prefix volume for a file 
by that name. If your Defaults.Text log and 
command file names end with a ".", FTS will look 
for a file with exactly that name without 


appending the ".text". 


If you prefer to direct FTS to a different 
volume for its log or command files, you can do 
so by providing the correct SOS device name or 
Pascal unit number. Remember that your "prefix 
volume" is the one that you booted from, unless 
you use the prefix option in the filer. 


FTS: CMD #5:filename (for Apple //) 
FTS: LOG .d2/filename (for Apple ///) 


The FTS boot diskette or volume that you created 
following the instructions in Chapter 2 already 
has a 50 Block log file called Ftslog.text on 
it. You can rename this file, or delete it and 
make it larger. If you wish to use a log file 
that is not called Ftslog.Text, remember to 
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place its name in the Defaults.Text file. 


If FTS finds no log file, it will create one 
that is 20 Blocks in size and will give it the 
name Ftslog.Text, unless you have specified a 
name in the Defaults.Text file. 


After FTS has found or created its log file, the 
following display appears: 


Press the space bar to change 
command file from Ftscmd.Text (or your filename) 
FTS will autostart in 10 seconds... 


FTS is showing you the name of the command file 
that it will expect to find. When the countdown 
completes, FTS will run that command file, 
provided it finds it on the boot or prefix 
volume. If FTS can not find a command file with 
the name being displayed, the following message 
appears: 


No command file name, (command file name) 
Enter command file name 

or RETURN for keyboard 

File? 


You can enter a different command file name at 
this point. This command file can be located on 
the boot (prefix) volume, or on any currently 
mounted volume (be sure to include device or 
unit number if on a volume other than the boot 
or prefix volume). 


The fact that FTS can use one of several command 
files is useful when you want FTS to complete 
the instuctions in one command file, terminate 
and automatically re-execute using a different 
command file. We explain this in more detail in 
Section 3.6 below and give examples in Chapter 
4. 
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3.3 Giving FTS Commands from the Keyboard 
When FTS is displaying the countdown and the 
name of the command file it will be using, you. 
can strike the space bar to interrupt the 
countdown. Then after the "File?" prompt, you 
can enter a <RETURN> to tell FTS that you want 
to enter commands directly from the keyboard. 


The following display appears: 


Enter commands from keyboard 


Terminate with “Quit”; 
2 


In Chapter 4, we explain how to build command 
files using the Pascal editor. Normally that 
will be the method you will use to issue 
commands to FTS. 


However, all of the same commands that can be 
fed to FTS through a command file can be typed 


in while it is in this keyboard mode. The 
difference is that your commands will not be 
saved once FTS is aborted. Also, you can not 


return to a command line to make a deletion or 
correction once you have typed a RETURN. The 
keyboard mode is convenient for an unusual task 
that you don’t expect to need again and that is 
simple to type in because it involves few 
command lines. 


3.4 How FTS Processes Commands 
When FTS has found its command file, or received 
a series of direct keyboard commands, it reads 


and validates the commands and internally stores 
the information they contain. As it is reading 
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in (compiling) the commands, FTS displays them. 
If the syntax is correct, FTS displays the "No 
Errors Detected” message. If errors are 
detected, FTS displays the errors as it finds 
them and then asks if you want it to continue 
reading in more commands or abort. It is 
convenient to have FTS continue to read in the 
commands after it has found an error, because it 
will find all your errors in one compilation. 
Then, after it aborts due to the errors, you can 
fix them and run it again. 


Once FTS has displayed the "No-Errors Detected" 
message, it is ready to begin doing its tasks. 
When a command file has been read in and 
determined to be without errors, you might want 
to implement the "NOLIST" option that prevents 
the commands from being displayed on the screen 
when FTS first runs the command file. This 
option is useful when command lines contain 
passwords that should not be viewed by 
individuals who might be in the FTS station 
area. Chapter 4 explains, in detail, how to use 
this option. 


After it has read and verified all of the 
commands, FTS can begin doing “globals.” Globals 
are tasks that FTS does without delay as soon as 
it has verified the contents of the command 
file. For example, a command file might contain 
three commands that request FTS to send the same 
file to three different locations. FTS will 
display the "Doing Globals” message and complete 
these tasks right away, aborting once it has 
completed them. 


It might, on the other hand, be preferable to 
have FTS transfer an updated version of a file 
to three locations, everyday, without operator 
intervention. If you want FTS to do a task at a 
particular time, or repeatedly at regular 
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intervals, you can enclose commands in a 
procedure and provide a schedule that FTS will 
use to do that procedure. 


3.5 How FTS Uses the Clock Calendar Card 


While FTS is running, it can use the services of 
the clock/calendar card to perform procedures at 
specified times. Network versions of FTS use the 
clock/calendar card installed in the file 
server. The standalone Apple // uses its own 
internal clock/calendar card. The standalone 
Apple /// has no clock/calendar card, but will 
utilize the Apple /// internal clock chip when 
available. Otherwise, a standalone Apple /// 
FTS can only perform global tasks or hand 
scheduled procedures. 


While it waits for the appropriate time to 
perform its procedure, FTS checks for incoming 
phone calls and for the <ESC> key to be pressed 
at the FTS station console. 


The operator can press the <ESC> key if he or 
she wants to hand schedule a procedure that is 
in the command file. Pressing the <ESC> key 
while FTS is waiting results in a menu display. 
From this menu the operator can select the hand 
scheduling option. 


In Chapter 4 we provide complete details about 
globals and the scheduling of procedures. 
3.6 How FTS Uses Multiple Command Files 
It is possible that the command file you create 
cannot be read in and validated by FTS because 


it requires more memory than is available in 
your FTS station. If this is the case, FTS 
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displays the "STACK OVERFLOW” error message and 
terminates. To correct this situation, you can 
create multiple command files and use the "SET 
CHAIN" feature described in detail in 
Chapter 4. By dividing your commands into 
multiple command files, and chaining from one 
file to the next, you can prevent the “Stack 
Overflow” error. Remember that this error only 
occurs with very long command files that occupy 
more memory than is available. 


3.7 How FTS Updates its Log File 


When FTS performs a significant task, it keeps a 
record of that task in the log file. You can 
check this log file to see what FTS has done, or 
to find out why FTS has not been able to 
complete a task. Since this log file is a fixed 
length, FTS places <<<END>>> after the last 
entry for the last session. It writes records 
circularly so that when the end of the file is 
reached, it starts at the beginning of the file 
and writes . over the previously logged 
information. 


When you are reading over this log, you can look 
for the <<<END>>> and for the date and time 
stamps at the beginning of each entry, to help 
you find the entry you are looking for. 
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Chapter 4 


Creating FTS Command Files 


4.0 Keywords and Command Lines 
FTS command files contain keywords, pathnames 
and other values that are arranged in command 


lines. 


The keywords that FTS understands are: 


ALWAYS FILE PASSWORD 
AT FOR... TIMES RECEIVE 
BEGIN HOUR(S) REPLACE 
CONNECT TO FILE ID RETRY IN 
DEFINE... AS IS PHONE SEND 
DELETE LIST SET CHAIN 
DIR MINUTE(S) SITE 
DO MYSITE SLOT 
END NFS STN 
EVERY NOLIST TO 
EXIT NOLOG USES 

VOL 


Some of these keywords, (SEND, RECEIVE, and 
BEGIN, for example), are found at the beginning 
of command lines. Other keywords have meaning 
within command lines. Some are only found in 
conjunction with each other (e.g. DEFINE ... AS, 
RETRY IN). We refer to a particular type of 
command line with the keyword that is found at 
the beginning, i.e. "the SEND” command line or 
the “CONNECT TO" command line. 


As you learn how to use these keywords, you will 
find that their meanings are fairly obvious and 
that the syntax rules for creating command lines 
are easy to remember. 
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The following sections explain the use of FTS 
keywords in combination with other command line 
components and are organized as follows: 


Section 4.1 introduces basic FTS syntax 
requirements by explaining how to issue commands 
for local transfer of virtual volumes, files and 
directories on the network. Standalone and 
network FTS operators should read this section, 
since it presents fundamental concepts that are 
true for all versions of FTS. 


Section 4.2 explains how to create and schedule 
FTS command file procedures. Commands can be 
enclosed in procedures when FTS is to perform 
them at a particular time every day or at 
specific intervals several times a day. 


Section 4.3 introduces the special commands and 
keywords that FTS requires in order to complet 
remote transfers. 


Section 4.4 covers the use of file server 
commands in a command file. These commands are 
used for setting default pathnames and 
passwords. 


Section 4.5 explains the use of macro 
definitions, that allow you to assign a name to 
a long string of characters that FTS 
understands. 


Section 4.6 explains how standalone FTS command 
files must differ from network command files. 


Section 4.7 describes the hand scheduling 
option. 


Section 4.8 provides longer sample command 
files. 
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The discussion below incorporates the following 
conventions: 


* Keywords are introduced gradually. Examples 
and discussions introducing new keywords are 
preceded by those keywords. 


* When we provide syntax models, square brackets 
[] enclose optional components, curly brackets 
{} enclose two or more keywords where exactly 
one is selected for a particular instance. 


* In examples of command lines, keywords appear 
in upper case and pathnames and other user 
supplied values appear in lower case. 


Once you understand the correct syntax of: the 
possible command lines and the purpose of each 
of the keywords, you can refer to the Quick 
Reference Guide in Appendix A for a summary of 
syntax rules. 


4.1 Syntax of Network FTS Commands 
for Local Transfers 


Networks can have one or more file servers, and 
file servers can manage one or more disks. 
Networks can be connected to other networks. A 
network FTS station can be used to transfer data 
between any of the file servers on any of the 
networks to which it is connected. When FTS is 
transferring data to its own or -connected 
networks, it is performing a local transfer. 
This section tells you how to give FTS local 
transfer instructions. 
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SEND, TO 


These keywords are used in the SEND command 
line. Its basic syntax is: 


SEND object TO object; 


SEND is a keyword that tells FTS that the 
subsequent object is to be transferred. 


TO is a keyword that tells FTS that the 
subsequent object is to be the destination of 
the data being transferred. 


VOL, DIR, FILE 


These keywords appear in objéct specifications. 
The basic syntax of object specifications is: 


{DIR|VOL} pathname, [SLOT n] [STN n] 
[FILE filename] 


Each object specification must have a pathname 
that specifies a directory or a volume. The DIR 
or VOL keyword must precede this pathname to 
indicate which is the case. 


Example: 


SEND VOL /main/sales/jim/leads, TO VOL 
/main/sales/alleads; 


In this example, the entire contents of the 
volume called /main/sales/jim/leads are being 
sent to a directory called /main/sales and 
placed in a volume that FTS will create and name 
alleads. 
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Note that the command lines in our examples 
occupy more than one line. If a command line is 
too large to be typed on one screen line, it can 
occupy two or more command lines. Also -note 
that pathnames must be terminated with commas, 
<RETURN>s or semicolons. 


Example: 


SEND DIR /main/sales/ jim/leads 
TO DIR /main/sales/ jane; 


As the DIR keyword indicates, a directory and 
the entire subtree that resides beneath it is 
being transferred. 


All of the branching subdirectories and volumes 
will be created under the specified destination 
directory. The destination directory can be an 
already existing one, or it can be created by 
FTS. In either case, the syntax is the same. 


Example: 


SEND VOL /main/users/ jeff/leads 
FILE march.text 

TO VOL /main/users/ jane/leads 
FILE jeffmarch.text; 


A file called "“march.text" is being transferred 
from one volume to another on the same hard 
disk. FTS creates a new file in an existing 
destination volume and gives the specified 
destination file name. 


Again, the VOL keyword tells FTS that the 
pathname specifies a volume. When a file is 
being transferred, the source and object 
specifications must contain pathnames that 
specify volumes and that are preceded by VOL. 
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The entire file name, including its suffix, must 
be specified exactly as it appears in the 
directory listing. 


Example: 


SEND VOL /main/users/ jeff/leads 
FILE march.text 

TO VOL /storage/sales/leads 
FILE march.text; 


Here, the source object is ona disk called 
/main and the destination object is ona disk 
called /storage. 


Example: 


SEND VOL /main/admin/report, FILE march.text 
TO VOL /main/sales/report, FILE admin.text 
TO VOL /main/r+d/report, FILE admin.text 

TO VOL /main/fin/report, FILE admin.text; 


Here, there are multiple destination objects. 
Any number of destination objects is allowed in 


the SEND command line that requests a local 
transfer. 


STN 


This keyword is used when a file server other 
than the default file server is being 
specified. 


It is a part of the object and requires an 
address value: 


STN $nn (where nn is the address in HEX) 
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Example: 


SEND VOL /main/sales/ jim/leads 
FILE march.text TO VOL 
/main/admin/leads, STN $FD FILE jim.text; 


Here, a file is being transferred between two 
file servers on one network. The source object 
is located on the default file server’s 
associated disk, and the destination object is 
located on a disk associated with a file server 
that has an address of $FD. The default file 
server is established at boot up. Objects need 
not include the file server address unless it is 
different than the default. 


SLOT 


This keyword is used to precede the slot 
specification when the object is located on a 
file server on a different, but connected, 
network. 


SLOT is a part of the object specification. It 
requires a slot number: 


SLOT n 
Example: 


SEND VOL /main/sales/jim/report, SLOT 4 
STN $CO TO VOL /admin/report/ jim 
SLOT 5, STN $FD; 


Here, neither the source nor the destination 
object is located on the default file server’s 
disk. Therefore, both require file server 
address specification. The slot numbers are 
also specified because both objects are located 
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on networks other than the default network. In 
order for FTS to service multiple networks, it 
must have network interface cards for them. The 
slot number provided in the object directs FTS 
to the appropriate network. 


DELETE, REPLACE 


These keywords are used when the source object 
is to be deleted after a successful transfer, 
and when the destination object already exists 
but is to be replaced by the object being 
transferred. 


Example: 


SEND VOL /buildinga/users/hal, DELETE 
TO VOL /buildinga/admin/reports, REPLACE; 


Here, a volume is being transferred to a 
different directory on the same file server 
disk. If a volume called "reports" exists under 
the directory /buildinga/admin, it will be 
replaced by the source volume. 


PASSWORD, LIST, NOLIST 


These keywords work together to protect the FTS 
console. 


Example: 


NOLIST; 

PASSWORD topsecret; 

LIST; 

SEND VOL /main/users/hal, FILE targets.text 
TO VOL /main/users/ricardo, FILE leads.text; 
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Here, the password protecting the console is 
"topsecret". The operator can interrupt the 
normal operation of FTS by typing <ESC> at the 
console, and selecting the "scheduling" option 
from the resulting menu. If the console is 
protected with a password, the operator is 
prompted to enter the password before the menu 
is displayed. 


In the above example, the NOLIST and LIST 
command lines are placed before and after the 
Password command line. This prevents FTS from 
displaying the password during the initial 
compilation. 


Example: 


NOLIST; 

SEND DIR /main/finance/salaries:gold 
TO /alt/finance/salaries:gold; 

LIST; 


Here, NOLIST again prevents a command line from 
being displayed on the FTS console during 
initial compilation. This is useful because the 
pathnames in the command line contain secret 
passwords. 


SUMMARY OF FUNDAMENTAL SYNTAX RULES 


* All command lines must be terminated with a 
semi-colon. 


* If a command line is longer than one screen 
line, it can be entered on two or more screen 


lines. 


* A pathname must be terminated by a comma 
unless it is immediately followed by a 
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<RETURN> or a semi-colon. 


* If the source object is a file, the 
destination object must be a file. The 
destination object must specify a virtual 
volume that already exists and provides a file 
name that FTS will give to the newly created 
file. 


* If the source object is an entire volume, the 
destination object must also be a volume. The 
destination object specification provides the 
name and directory location to be given to the 
newly created volume. 


* If the source object is a directory, the 
destination object is a directory. The 
branching subtree of the source directory will 
be placed in the directory named in the 
destination specification. The directory named 
in the destination specification may already 
exist, or it can be created by FTS. 


* If a file, volume, or directory already exists 
and is specified to be the destination object, 
the transfer will not occur unless the REPLACE 
keyword is present. 


* If an object contains no STN or SLOT keywords 
and their associated values, FTS assumes that 
the default file server on the default network 
is to be used. The default file server is 
established at the time of FTS startup. You 
can view the slot number and station address 
of the default file server by using the 
CMD.CODE program’s SHOW NFS command. 
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4.2 Syntax for Creating and Scheduling 
Procedures 


If FTS is supplied with a SEND command that is 
not part of a procedure, it will attempt to 
accomplish the requested transfer without delay. 
Once it has finished the transfer, it will cease 
running (abort) unless there are more SEND 
commands for it to execute. 


If the SEND command is enclosed in a procedure, 
it will not be executed until it is scheduled. 
When FTS is given a procedure, it looks for 
instructions from the command file or the 
console that tell it when that procedure should 
be executed. In this section we explain how to 
create procedures and how to provide scheduling 
commands for them. In Section 4.7 we explain how 
to hand schedule procedures. 


BEGIN, END, EVERY, HOUR(S), MINUTE(S), DO 


Procedures’ are contained between the BEGIN and 
END command lines. 


BEGIN taskname; 
e.. body of task .-. 
END; 
The keyword EVERY begins a command line that 
tells FTS when to do a named procedure. HOURS 
and DO are keywords found in the EVERY command 


line. 


The BEGIN and EVERY command lines can take the 
following forms: 
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BEGIN taskname [NOLOG] [EXIT]; 
EVERY n HOUR(S) DO taski[,task2, task3]; 
EVERY n MINUTE(S) DO taskl1[, task2, task3]; 


The following example shows the use of the 
BEGIN, EVERY, HOURS, and DO keywords. NOLOG and 
EXIT are explained in subsequent examples. The 
EVERY command line can also contain the RETRY 
clause that is useful for remote transfers (see 
Section 4.3). 


Example: 


BEGIN taskl; 

SEND VOL /main/sales/newreq/detroit 
TO VOL /main/sales/Hal/req; 

END; 


EVERY 24 HOURS DO taskl; . 


BEGIN is followed by the name you wish to give 
to the procedure. In this case the name is 
TASK1. Each procedure is preceded by the BEGIN 
command line. Each procedure is followed by the 
END command line. 


Note that semi-colons follow the BEGIN and END 
command lines as well as the SEND command line 
contained within the procedure. 


EVERY, HOURS, and DO mean just what they say. 
They tell FTS to do the procedure at reqular 
intervals of your choice. Note that TASK] must 
be provided at the end of this schedule command 
line so that FTS knows which task you are 
referring to». One command file can have many 
procedures and schedule commands for each of 
them. 
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Example: 


BEGIN TASK1; 

SEND DIR /main/users/ joe/newmail, Slot 4 
STN $FD TO DIR /main/users/ joe/newmail 
SLOT 6, STN $FE; 

END; 


EVERY 2 HOURS DO TASK1; 


Some applications, The Messenger electronic mail 
package for instance, can be greatly enhanced if 
FTS services are used to transfer objects from 
one location to another on one network or 
between connected networks. This service becomes 
especially valuable if commands can be repeated 


at regular intervals without operator 
intervention. If a network FTS received the 
above command file, it would perform the 


transfer every two hours. This means that mail 
that is directed to joe from users of a 
connected, but different, network can be 
temporarily stored on that different network and 
then transferred automatically by FTS to Joe’s 
own network at regular intervals. 


AT 


This keyword is found at the beginning of 
another type of scheduling command line. 


Examples: 
AT 0900 DO newday; 
AT 0900,0915,1345 DO taskl, task2, task3; 


The AT command specifies that a procedure or 
group of procedures is to be done at a 
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particular time or times during the 24 hour day. 
Note that the specification of the time is in 
hours and minutes (hhmm). 


NOLOG 


Place this keyword in the BEGIN command line 
when you don't want FTS to make log entries each 
time it completes the activities within a 
procedure. 


Example: 


BEGIN task1 NOLOG; 

SEND DIR /main/sales/leads/new, DELETE 
TO DIR /main/users/gina/leads, REPLACE; 
END; 


EVERY 4 HOURS DO taskl; 


Here, FTS is being instructed not to bother 
logging the activities in this procedure. When 
procedures are done frequently, the log entries 
for their contained activities will quickly fill 
the log file, making other, less frequent, 
entries harder to locate. 


EXIT, SET CHAIN 


These keywords can be used in a procedure to 
tell FTS to terminate its operation after 
completion of the procedure, and to chain to a 
specified program. 


The EXIT keyword is placed in the BEGIN command 


line. The SET CHAIN command line is placed 
before the END; command line and takes the 
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following form: 
SET CHAIN programname [ (parameter) ]; 
Example: 


BEGIN taskl EXIT; 
SEND VOL /main/admin/report, FILE march 
TO VOL /main/sales/report, FILE admin REPLACE; 


SET CHAIN fts2nmicro (Ftscmd2.text); 
END; 


AT 0330 DO taskl; 


Here the BEGIN command line contains the keyword 
EXIT. FTS knows to do the activities in the 
procedure and then to check the SET CHAIN 
command line for the program it is to chain to. 
When the named program is FTS, as is the case 
here, the name of the command file that FTS is 
to use when it starts up again is contained 
within parenthesis. Having FTS terminate and 
start up again using a different command file is 
useful when the commands in one command file can 
not fit in memory for processing. (See Section 
3.6.) 


Chaining from FTS to FTS is also useful for 
remote transfers as we explain in 4.3 below. 


4.3 Remote Transfers 


Successful transfer of data over phone lines 
requires two FTS stations, two modems and a 
coordinated effort by the operators. The 
operators agree on site names, object ID names 
and modem modes, and create command files 
accordingly. 
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Objects are specified in the same way for remote 
transfers as for local transfers, but there is 
an important difference in their placement. The 
source object specification is placed in the 
sending FTS command files SEND command line, 
and the destination object is placed in the 
receiving FTS command file's RECEIVE command 
line. One FTS command file must have a SEND 
command line that contains an ID. The other FTS 
command file must have a RECEIVE command line 
that contains a matching ID. 


This section introduces new keywords, RECEIVE 
and ID for example, and syntax requirements that 


you need to know in order to create command 
files for remote transfers. 


MYSITE, SITE, USES IS PHONE, 
CONNECT TO SITE, ALWAYS, RECEIVE, 
ID, RETRY IN, FOR... TIMES 


These keywords are used to provide FTS with the 
instructions it needs to connect to a remote 
site. 

Note the proper syntax for them: 


MYSITE sitename [USES <USES string>]; 


SITE sitename [IS PHONE number] [USES 
<USES string>]; 


BEGIN taskname [NOLOG] [EXIT]; 

CONNECT TO SITE sitename [ALWAYS]; 

RECEIVE ID idname TO object [REPLACE]; 

The RETRY clause can be added to the AT and 


EVERY | command lines. It can take the following 
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forms: 

[RETRY IN n HOUR(S)[FOR n TIMES] ]; 
or 

[RETRY IN n MINUTE(S)[FOR n TIMES]]; 


Below are sample command files that might be 
created by three different FTS operators, one in 
the home office and two in different branch 
offices. These command files contain the 
keywords introduced above. Read over the 
command files briefly, noting the syntax of the 
SEND (and RECEIVE command lines which have 
compatible IDs. A complete explanation of the 
new keywords follows the command files. Then we 
include a summary of the activity that would 
result if these FTS command files were run on 
three FTS stations. 


Note that all three FTS stations in the 
following examples are running on networks. 
Samples of standalone FTS command files are 
included in Sections 4.6 and 4.8. 
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The home office”’s command file: 


MYSITE home USES 1200; 
SITE branchl IS PHONE 123-4567 USES 300; 
SITE branch2 IS PHONE (213) 522-3333 USES 1200; 


BEGIN createupdate; 

SEND /main/users/bill/reports, FILE daily.text 
TO /main/users/reports 

FILE daily.text REPLACE; 

END; 


BEGIN callbranchl; 

CONNECT TO SITE branchl ALWAYS; 
SEND VOL /main/users/reports 
FILE daily.text ID update; 

END; 


BEGIN callbranch2; 

CONNECT TO SITE branch2; 
SEND VOL /main/users/reports 
FILE daily.text ID update; 
“END; 


RECEIVE ID april 
TO VOL /main/account/expense/ jim, REPLACE; 


RECEIVE ID payroll TO VOL /main/finance 
REPLACE; 


_ AT 0100 DO createupdate; 


AT 0300 DO callbranchl, RETRY 
IN 10 MINUTES FOR 5 TIMES; 


AT 0400 DO callbranch2, RETRY 
IN 10 MINUTES FOR 5 TIMES; 
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Branch 1°s command file: 


MYSITE branchl USES 300; 
SITE home; 
SITE branch2; 


RECEIVE ID update TO VOL /main/home/reports 
FILE daily.text REPLACE; 


BEGIN answerhome;3 

CONNECT TO SITE home; 

SEND VOL /main/expense/Jim, ID april; 
END; 


Branch 2°s command file: 


MYSITE branch2 USES 1200; 
SITE home; 
SITE branchl; 


RECEIVE ID update TO VOL /main/home/reports 
FILE daily.text REPLACE; 


BEGIN answerhome;3 

CONNECT TO SITE HOME; 

SEND VOL /main/users/lynne, ID payroll; 
END; 


These example command files contain all of the 
(additional) FTS keywords necessay for remote 
transfers. 


The MYSITE and SITE command lines establish 
names for the local and remote sites. 
Optionally, the SITE command line can contain 
the IS PHONE clause. Sites that are 
originating remote connections need to know 
the phone numbers of stations they are to 
call. In this example, the home office (home) 
originates calls to two of its branch offices 
(branchl and branch2). Therefore the command 
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file at the home office contains phone numbers 
for these branches. 


NOTE: FTS understands phone numbers entered in 
any of the following ways: 


(123) 456-7891 
123 457 7891 
123-456-7891 


A period can be placed between any of the 
numbers to cause a omne-second pause, as 
might be useful when placing calls through a 
PBX board that requirés that 9 be dialed to 
obtain an outside line. 


e 9-123-456-7891 


When a procedure that involves making a phone 
call is scheduled, the necessary phone number 
needs to be provided on the SITE command line. 
Otherwise, FTS will attempt to dial a null 
phone number. 


Such a phone call will be unsuccessful with 
FTS thinking that the destination site did not 
answer for some reason. 


The optional USES clause in the SITE command 
line tells FTS what mode its modem should use 
for calling a particular FTS station. The 
optional USES clause in the MYSITE command 
line tells FTS what mode its modem should use 
when answering an incoming call. 


In this example, "home" will use 300 when it 
calls “branchl" and 1200 when it calls 
“pranch2". The branch offices receive data and 
they send data. The modem mode is established 
by the caller and is not changed during one 
call. If, however, the command file were 
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configured so that the branch offices 
originated calls to the home office, their 
command files would require the home office 
phone number as well as the an appropriate 
USES clause. The operators at the branches and 
the home office would have to coordinate their 
USES clause values. Whereas home can switch 
to 1200 when it calls a site with a 1200 in 
its USES clause, it must always receive calls 
in the 300 mode if that is the value in the 
MYSITE command line. Therefore, the command 
files of the branch offices must have 300 in 
their SITE home USES clause. 


The appendices of this manual explain the USES 
clauses appropriate for supported modems. In 
Many cases no USES clause is required because 
no mode changes need to be made for successful 
connection to occur. 


When a procedure involves a remote transfer, 
the CONNECT TO SITE command line must be the 
first command line in the . body of the 
procedure. Whether FTS is originating or 
answering a call, it requires the CONNECT TO 
SITE command line to associate a procedure 
with a particular site. 


The ALWAYS keyword is an optional component of 
the CONNECT TO command line when FTS is to 
originate the call. It tells FTS to originate 
the call even if it can’t find the object it 
is to send. 


If the ALWAYS keyword is not present, FTS will 
not connect to the remote location if the 
source object is not present. 


The home office command file contains one 


local and two remote procedures. Note the 
difference in syntax between remote and local 
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procedures. The remote procedure does not 
specify a destination object, but it does 
contain ID idname. 


The specification of the destination object is 
contained in a RECEIVE command. A RECEIVE 
command must exist in the command file of the 
receiving FTS, and it must contain an ID that 
matches the one in the SEND command, as well 
as an object specification that is compatible 
with that of the source object. 


Note that the syntax for object specification 
is exactly the same as for local transfers. 
But, the destination object is specified in 
the receiving FTS command file as part of the 
RECELVE command line. The RECEIVE command line 
is never enclosed in a procedure. It can not 
be scheduled since it is only acted upon when 
a remote FTS sends an object with a 
corresponding ID. 


The RETRY keyword in the AT command line tells 
FTS to try again if the phone connection is 
not made. Note that in this case, FTS is being 
told to retry in 10 minutes, and again in 10 
more minutes. After 5 retries FTS is told to 
give up. RETRY is useful if the remote FTS 
doesnt happen to be operational at the time 
of the first call. RETRY IN n HOUR(s) is also 
allowed. i 


A REMINDER 

When constructing command files that are to be 
used for remote transfers, it is important to 
keep in mind the fundamental requirements of FTS 
for object specification. 

* Pathnames can specify volumes or directories. 


Therefore, they must be preceded by the VOL or 
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DIR keyword. 


* If the SEND command line pathname specifies a 
volume so must the RECEIVE command line. 


* If the SEND command line specifies a DIR, so 
must the RECEIVE command line. 


* If the SEND command line includes the FILE 
keyword, so must the RECEIVE command line. 


* Section 4.1 explains the VOL to VOL, DIR to 
DIR, FILE to FILE requirement in greater 
detail. , 


SUMMARY OF SAMPLE COMMAND FILE ACTIVITIES 


The above sample command files describe the 
following events. 


At 1:00 every morning, daily.text is moved from 
one location to another on the home offices 
disk. 


At 3:00 every morning, the home office initiates 
a remote connection in accordance with its AT 
command line for the callbranchl procedure. In 
order to initiate the connection, home checks 
the branchl IS PHONE and USES clauses for a 
phone number and appropriate modem mode. 


HOME calls branchl using the 300 mode. Then, it 
transfers an object with the ID “update”. 
Branchl has a RECEIVE command with the ID 
“update”, and a compatible destination 
specification. The transfer is made. 


Then branchl checks to see if it has a CONNECT 
TO SITE home command. It does. Branchl sends an 
object with the ID “april” to home. Home has a 
RECEIVE command line with the ID “april”. The 
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object specifications are compatible, so the 
transfer is made. The communication is 
terminated. 


At 0400 every morning, home dials branch2, 
changing its modem mode to 1200 due to branch2’s 
USES clause. Home sends ID “update”. Branch2 
receives it. Branch2 checks for a CONNECT TO 
SITE home command, finds one and sends the 
object associated with ID “payroll.” The 
communication is terminated. 


4.3.2 More About RECEIVE Command Lines 


In Chapter 3 we explained that FTS can do 
"globals" without delay. We explained that a 
global command .is one that is not contained 
within a procedure. Although a RECEIVE command 
is never enclosed ina procedure, it is not a 
"global". It can not be executed without delay 
since its execution depends upon another FTS 
station sending data with a compatible ID. A 
command file with a RECEIVE command will cause 
FTS to continue running. 


The following example shows how a dummy RECEIVE 
command line is placed in a command file to keep 
FTS running while it awaits calls from the home 
office. Each time it receives the call from the 
home office it does its unscheduled procedure. 
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Example: 
The home office command file is; 


MYSITE home; 
SITE branchl IS PHONE 123-4567; 


BEGIN branchl; 


CONNECT TO branchl; 
END; 
RECEIVE ID mail TO DIR /main/users/newmail; 


AT 0500 DO callhome branchl RETRY IN 1 HOUR; 


The branch office command file is: 


MYSITE branchl 
SITE home; 


BEGIN sendhome; 


CONNECT TO home; 
SEND DIR /main/users/home/newmail, ID mail; 
END; 


RECEIVE ID dummy TO VOL /main/users/zip; 


Since the branch office is only to receive 
calls, it has no schedule command. However, the 
dummy . RECEIVE command line is used to prevent 
FTS from aborting. 


This tactic can also be used when several 
procedures are placed in a command file and are 
to be hand scheduled later. 

4.4 File Server Commands 

FTS accepts file server commands in its command 


files. These commands are useful for setting 
default passwords and default directories. You 
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will find that employing these commands makes 
your command files shorter and easier to read. 


NFS 


File server commands outside of procedures are 
executed once after compilation. Those inside of 
a procedure are executed whenever a procedure is 
scheduled, and they remain in effect until they 
are changed by other NFS commands that are 
inside another procedure. 


Instead of typing the following: 


SEND VOL /main/users/abc/newmail:gold, To 
VOL /main/users/abc/oldmail:gold 


SEND VOL /main/users/xyz/newmail:gold TO 
VOL /main/users/xyz/oldmail: gold; 


You might want to type: 


NFS SET PRVPW=gold; 

NFS SET DIR /main/users; 

SEND VOL abc/newmail, TO abc/oldmail 
SEND VOL xyz/newmail TO xyz/oldmail; 


The file server commands in this example affect 
the pathnames because the passwords and default 
partial pathnames are preset. Note that the 
opening / is left off of “abc/" and “xyz/" so 
that the default partial pathname is appended. 


4.5 Macro Definitions 


DEFINE... AS 


"Macros" can be used to eliminate the need to 
type a frequently used string over and over 
again in your command file. For example, if many 
references are made to SLOT 4 STN $CO, a macro 
can be defined at the beginning of the command 
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file that associates a simpler name with a 
longer or less mnemonic string. 


Example: 
DEFINE fserver AS SLOT 4 STN $CO; 
Then a send command might be: 


SEND VOL /main/users/jose, fserver TO VOL 
. /main/users/ralph; 


Example: 
DEFINE fast AS 1200; 

Then a MYSITE command might be: 
MYSITE home USES fast; 


Remember, a macro is only defined once, and it 
affects all instances where the substitute term 
is used, whether those instances are inside or 
outside of a procedure. 


4.6 Standalone FTS Command Files 


Standalone FTS stations can send or receive DOS, 
PASCAL, SOS, and CPM type volumes. Individual 
files within Pascal and SOS volumes can also be 
sent or received between any combination of 
standalone or network FTS station. 


For the most part, command files for standalone 
FTS stations follow the same syntax rules and 
use the same keywords as do the command files 
for network FTS stations. There are some 
exceptions, however: 


* The object specification syntax is different 
for standalone SEND and RECEIVE command lines, 
because the objects being specified do not 
contain network pathnames. The DIR keyword is 
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not used because standalone FTS command lines 
can not contain pathnames that specify 
directories. The VOL and FILE keywords are 
used to distinguish the object as a file or an 
entire volume. Another type of keyword is used 
to tell what type of volume is being sent or 
received. 


* Procedures are created in exactly the same way 
as they are for the network versions of FTS. 
But, since the Apple /// does not contain a 
clock calendar card, command file scheduling 
commands will not work. Instead, the Apple /// 
FTS command file procedures must be activated 
by an incoming call, or by the operator who 
hand schedules the procedure. 


In this section we describe the proper syntax 
for the SEND and RECEIVE command lines when used 
with the standalone versions of FTS. Then we 
provide examples of command files that 
accomplish various types of transfers. 


The proper syntax for the SEND command line when 
a volume or file is being sent from a standalone 
FTS station is: 

SEND object ID idname; 
The proper syntax for the RECEIVE command line 
when a volume or file is being received at a 


standalone FTS station is: 


RECEIVE ID idname TO object; 


The proper syntax for object specification when 
the object is a volume is: 


{SOS|PASCAL|DOS|CPM} VOL {#unitnumber]|.devicename} 


NOTE: Volume names are not acceptable. Apple // 
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object specifications require unit numbers, such 
as #4 or #5. Apple /// object specifications 
require device names, such as .dl or .profile. 


The proper syntax for object specification when 
the object is a file is: 


{SOS|PASCAL} FILE filename; 


If the file is to be sent or received toa 
volume different than the prefix volume, the 
pascal volume number or SOS device name must be 
specified. 


Examples: 


An Apple // FTS station initiates a call to an 
Apple /// station, transfers a volume, and 
receives a file: 


MYSITE branchl USES 1200; 
SITE branch2 IS PHONE 123-4567 USES 300; 


BEGIN branch2call; 
CONNECT .TO SITE branch2; 
SEND CPM VOL #5 ID update; 
END; 

RECEIVE ID new TO PASCAL FILE #6:sales.text REPLACE; 


AT 0300 DO branch2call; 
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An Apple /// FTS station receives the call 


from branchl, receives ID update and, in 
turn, sends ID new: 


MYSITE branch2 USES 300 
SITE branchl USES 1200 


BEGIN branchlsend; 

CONNECT TO SITE branchl; 

SEND PASCAL FILE .profile/sales.text 
DELETE ID new; 

END; 


RECEIVE ID update TO CPM VOL .d2; 


In this example, “branch 1" is sending a volume, 
and branch 2 is sending a file. Note the object 
specifications. Volumes can be SOS, DOS, PASCAL, 
or CPM types. Here the volume being transferred 
is a CPM type. Files can only be SOS or PASCAL. 
Here the file being sent is a PASCAL type. 


The Apple // initiates the call at the time 
specified in its schedule command line. The 
Apple /// can receive the call without operator 
intervention. The Apple /// FTS command file has 
a compatible RECEIVE command line, allowing it 
to receive the volume being transferred to it. 
The Apple /// also has a procedure containing a 
CONNECT TO SITE branchl command. This means 
that it can send its file to branch 1 when 
branch 1 calls. 


Calls can be initiated by Apple /// FTS 
stations, when the command file contains the 
phone number of the remote FTS station, a 
procedure with the appropriate CONNECT TO SITE 
command line, and when the procedure is hand 
scheduled. We discuss hand scheduling of 
procedures in Section 4.7 below. 
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RULES TO REMEMBER 


* If a volume is being sent from a network FTS 
station to a remote standalone FTS, the 
operators must agree in advance as to the type 
of volume being sent. Although the network 
FTS does not require the volume type keyword, 
the standalone FTS does. 


* If a network FTS is sending a volume or a file 
to the standalone FTS, that volume or file 
Must not be larger than the available real 
disk space associated with the standalone 
FTS. 


* Standalone Apple /// FTS station operators 
must use the hand scheduling option if they 
want to initiate calls. They, can, however 
configure their command files such that data 
can be sent when remote FTS stations initiate 
calls to their stations. The CONNECT TO 
command line within the procedure that is to 
become active must contain the SITE name that 
matches that of the calling station. 


* Just as is true with network FTS stations, 
care must be taken to give FTS commands that 
keep its standalone station running when no 
scheduling command exists for a procedure. 


For instance, an Apple /// might only contain 
a series of procedures that are to be 


activated when various FTS stations call it. A 
RECEIVE command must be present, even if it is 


a . "dummy" one. The RECEIVE command keeps FTS 
running because it waits to RECEIVE’ a 
transmission with the appropriate ID. If no 
such transmission occurs, FTS will ` keep 
running. 


* Section 1.2 of this manual states that Apple 
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/// standalone FTS stations must be used with 
at least two drives. It is possible, however, 
to use a single-drive system to transfer or æ» 
receive SOS files. Doing so is not recommended 
since it requires operator intervention to 
swap diskettes during the transfer process. If 
you decide to try this approach, you may wish 
to use a two-stage boot process if the file 
being sent or received will physically fit on 
the diskette that contains the Pascal system 
files and the FTS code and text files. 
Otherwise, you will need to prepare a diskette 
with the same volume name as the Pascal boot 
diskette and move the FTS code and text files 
onto it. 


4.7 Hand Scheduling of Tasks 


To hand schedule a task strike the <ESC> key to 2 
interrupt FTS. If a password is set, you will be 
asked to type the password before the following 

menu will appear: 


C(ontinue), P(assword, Q(uit), S(chedule), R(estart)? 
You can select: 

"C" to let FTS continue execution 

"P" to change or turn off the password 

"Q" to halt FTS 

"S$" to hand schedule a procedure 

“R” to restart FTS a 
When "S" is selected, a list of the currently 


internalized procedures is displayed. Select one 
for immediate execution. 
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When “P” is selected, a new console password may 
be entered. This password overrides any password 
that might be set in the pending command file. 


4.8 More Sample Command Files 


This chapter provides complete command files for 
some possible implementations of FTS. 


4.8.1 Remote Transfer between Standalone 
FTS Stations 


The following sample command files give 
instructions for remote transfers between a 
standalone Apple // and a standalone Apple ///. 


The Apple // Command File: 


MYSITE brooklyn USES NOVATION + 1200; 
SITE omaha IS PHONE (111) 123-4567 USES 300; 


RECELVE ID expense TO PASCAL VOL #5; 


BEGIN callomaha NOLIST; 

CONNECT TO SITE omaha; 

SEND PASCAL FILE #5:report.text ID june; 
END; 


AT 0500 DO callomaha RETRY IN 1 HOUR FOR 2 TIMES; 


The Apple /// Command File: 


3/1/83 4-33 


COMMAND FILES 


MYSITE omaha USES 300; 
SITE brooklyn; 


RECEIVE ID june TO PASCAL 
FILE .d2/brook.text REPLACE; 


BEGIN answerbrook; 

CONNECT TO SITE brooklyn; 

SEND PASCAL VOL .d2 ID expense; 
END; 


4.8.2 Local Network Transfers and Remote 
Network to Remote Network Transfers 


In the following example, FTS is used to enhance 
the Messenger electronic mail package by 
performing local and remote transfers. Users 
newmail volumes are routed from one local file 
server to another and between remote locations. 


Notice that explanatory comments are enclosed in 
(* *). These comments are ignored by FTS but 
make the command file easier for readers to 
understand. 


MYSITE nestar; 


SITE nyro; 

(* NY regional office; NEW YORK *) 
SITE ops IS PHONE 493-8031; 

(* Nestar’s Operation; building 2 *) 


(* Macro definitions for connected networks *) 
DEFINE bach AS slot 6; 

DEFINE beethoven AS slot 4; 

DEFINE bartok AS slot 2; 

(* Issue file server requests to set default 


directories and passwords *) 
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NFS bach set dir /main/users; 
NFS beethoven set dir /main/users; 
NFS bartok set dir /main/users; 


NOLIST; 

NFS bach set prvpw=secret; 

NFS beethoven set prvpw=secret; 
NFS bartok set prvpw=secret3 
LIST; 


(* Receive statements for incomming mail *) 
(* addressed to personal ids *) 


RECEIVE ID hjsmail 

TO DIR hjs/newmail, beethoven; 
RECEIVE ID 1jsmail 

TO DIR 1js/newmail, bach; 
RECEIVE ID plhmail 

TO DIR plh/newmail, beethoven; 
RECEIVE ID dmkmail 

TO DIR dmk/newmail, bartok; 


(* Re-route files locally between connected *) 
(* networks *) 


BEGIN localstuff NOLOG; 
SEND DIR hjs, bach DELETE 
TO DIR hjs, beethoven; 
SEND DIR hjs, bartok DELETE 
TO DIR hjs, beethoven; 
SEND DIR plh, bartok DELETE 
TO DIR plh, beethoven; 
SEND DIR plh, bach DELETE 
TO DIR plh, beethoven; 
SEND DIR ljs, beethoven DELETE 
TO DIR 1ljs, bach; 
SEND DIR 1ljs, bartok DELETE 
TO DIR 1ljs, bach; 


(* Gather files for operation personnel *) 
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(* under ops directory on bartok for *) 
(* later forwarding by phone to site *) 


(* ops. *) 


SEND DIR dmk, bach DELETE 
TO DIR ops/dmk, bartok; 
SEND DIR dmk, beethoven DELETE 
TO DIR ops/dmk, bartok; 
SEND DIR dmk, bartok DELETE 
TO DIR ops/dmk, bartok; 
° (* and so on *) 
SEND DIR adn; bach DELETE 
TO DIR ops/adn, bartok; 
SEND DIR adn, beethoven DELETE 


TO DIR ops/adn, bartok; 


SEND DIR adn, bartok DELETE 
TO DIR ops/adn, bartok; 


*) 
“a 
z) 


END; 

(* Communicate with NY regional office. Since *) 
(* we did not define a phone number for site 
(* nyro, we will rely on them to initiate the 
(* connection. Individual mail messages are 
(* received under users” directory on bach 

(* later distribution, and other volumes are 
(* received under a predesignated directory. 
(* Outgoing mail and volumes are directed to 
(* similar ids at site nyro. For example, to 
(* send mail to Joe in NY via the Messenger, 
(* one would enter “NYRO/JOE~ as the receiver 
(* ID, and FTS will forward it to NY“s FTS 

(* which will create the new mail volume 

(* under /main/users/ joe/newmail/... for 

(* interpretation by Messenger in NY. 


RECEIVE ID nyromail 


TO 


DIR /main/users, bach; 


RECEIVE ID nyrovols 
TO DIR /main/incoming/nyro, bach; 
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BEGIN nyrostuff; 
CONNECT TO SITE nyro; 
SEND DIR nyro, beethoven 
DELETE ID nestarmail; 
SEND DIR nyro, bartok 
DELETE ID nestarmail; 
SEND DIR nyro, bach 
DELETE ID nestarmail; 
SEND DIR /main/outgoing/nyro, beethoven 
DELETE ID nestarvols; 
SEND DIR /main/outgoing/nyro, bartok 
DELETE ID nestarvols; 
SEND DIR /main/outgoing/nyro, bach 
DELETE ID nestarvols; 
END; 


(* Distribute group mail to individuals 


BEGIN broadcast NOLOG; 
SEND DIR staff/newmail, bach 
DELETE TO DIR staff/newmail, bartok; 
SEND DIR staff/newmail, beethoven 
DELETE TO DIR staff/newmail, bartok; 
SEND DIR staff/newmail, bartok 
DELETE TO DIR rnd/newmail, bach 
TO DIR mktg/newmail, beethoven 
TO DIR ops/newmail, bartok 
TO DIR hjs/newmail, beethoven; 


SEND DIR ops/newmail, bach 

DELETE TO DIR ops/newmail, bartok; 
SEND DIR ops/newmail, beethoven 
DELETE TO DIR ops/newmail, bartok; 


SEND DIR rnd/newmail, bartok 
DELETE TO DIR rnd/newmail, bach; 
SEND DIR rnd/newmail, beethoven 
DELETE TO DIR rnd/newmail, bach; 
SEND DIR rnd/newmail, bach 
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DELETE TO DIR 1js/newmail, bach 
TO DIR jad/newmail, bach 


Š (* and so on *) 
TO DIR eps/newmail, bach; 
END; 
(* Communicate with Operations department at *) 
P P 


(* site ops. We “always” call ops even with *) 
(* nothing to send, just in case they have *) 


(* something to send to us. Outgoing ops *) 
(* mail were gathered (by localstuff) on *) 
(* bartok. *) 


RECEIVE ID opsmail TO DIR /main/users, bach; 
BEGIN opsstuff; 


CONNECT TO SITE ops, ALWAYS; 
SEND DIR ops, bartok DELETE ID nestarmail; 


END; 

(* Schedule periodic and daily procedures *) 
EVERY 90 MINUTES DO localstuff; 

EVERY 3 HOURS DO broadcast; 


AT 0800,1200,1500,1800 DO opsstuff, 
RETRY IN 10 MINUTES FOR 3 TIMES; 
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Reference Guide 


A.l Keywords 


In the following list of FTS keywords, ** 
follows each keyword that can only be placed 
within a procedure. * follows each word that 
can only be placed outside of a procedure. All 
other keywords can appear either in or outside 
of a procedure. Procedures are defined in A.4. 


ALWAYS** FOR ...TIMES* REPLACE 
AT* HOUR(S)* RETRY IN* 
BEGIN** ID SEND 
CONNECT TO SITE** IS PHONE* SET CHAIN** 
DEFINE ... AS* LIST SITE* 
DELETE MINUTE(S)* SLOT 

DIR MYSITE* STN 

DO* NFS TO 

END** NOLIST USES* 
EVERY* NOLOG** VOL 
EXIT** PASSWORD* 

FILE RECEIVE* 


A.2 Syntax of FTS Command Lines Understood by 
FTS 


* All command lines must end with a semi-colon. 


* Command lines can be entered on multiple 
screen lines. 


* Pathnames must be terminated with a comma, a 
<RETURN>, or a semi-colon. 


* Blank lines in command files are ignored. 
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* Enclose comments in (* comments *) and place 
them on separate lines. 


*Blanks or commas can be used to delimit 
multiple values in command lines. 


Below, command lines are listed alphabetically 
according to the keyword at the beginning. The 
syntax for specifiation of object is provided in 
A.3.1 and A.3.2 below. 

1. AT hhmm DO taskname [RETRY IN (see below)]; 


RETRY IN nn HOUR(S) [FOR nn TIMES] 
RETRY IN nn MINUTE(S) [FOR nn TIMES] 


The AT command line can contain multiple times 
and multiple tasks: 


AT 0900, 1300, 1650 DO taskl, task2, task3; 
If multiple.tasks are specified FTS will do 
them in the reverse order that they appear in 
the command file. 

2. BEGIN taskname [NOLOG] [EXIT]; 

3. CONNECT TO SITE sitename [ALWAYS]; 

4, DEFINE <macroname> AS <macrobody>; 


5. END; 


6. EVERY n {HOUR(S)|MINUTE(S)} DO taskname 
[RETRY clause (see below)] 


RETRY IN nn HOUR(S) FOR nn TIME(S); 
RETRY IN nn MINUTE(S) FOR nn TIME(S); 


The EVERY command line can have multiple 


A-2 3/1/83 


QUICK REFERENCE 


tasknames: 
EVERY 6 HOURS DO taskl, task2, task3; 
7. LIST; 


LIST can be used as a separate command line 
inside or outside of a procedure. 


8. MYSITE sitename [USES <uses string>]; 


Possible USES strings are: 
300 (sets 300 baud) 
1200 (sets 1200 baud) 


NATIONAL (sets 40ms delay between Rts 
and start of data) 


INTERNATIONAL (sets 240ms delay between 
Rts and start of data) 


NOVATION (sets 1000ms delay between Rts 
and start of data) 


PULSE (sets pulse dialing) 
TONE (sets tone dialing) 


If more than one USES statements are needed, 
specify as follows: 


USES TONE+NATIONAL; 


To find possible USES strings for your modem, 
see appropriate appendix. 


9. NOLIST; 
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10. 


ll. 


12. 


13. 


14. 


15. 


16. 


NOLIST can be used as a separate command line 
inside or outside of a procedure. 


NFS [SLOT n] [STN $nn] nfscmd 
PASSWORD password; 
RECEIVE ID idnamé TO object [REPLACE]; 


SEND object [DELETE] TO object [REPLACE] 
[TO object [REPLACE]]...; 


Local send command lines can contain 
multiple destination objects. 


SEND object [DELETE] ID idname; 


SET CHAIN programname [(optional FTS cmd 
file name) ]; 


SITE sitename [IS PHONE number] [USES 
<use string>]; 


Phone numbers can be entered in the 
following ways: 


123-456-7891 
(123) 456-7891 
123 456 7891 


Either spaces, hyphens or parenthesis can 
delimite the parts of the phone number. A 
period can be entered before any number to 
cause a omne-second pause. This is useful 
when calls are being placed through a PBX 
and 9 must be dialed to reach a dial tone. 


9. 123 456 7891 


(see MYSITE for USES string variations) 
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A.3 Object Specification 
A.3.1 Object Specification in Network FTS 
Command Lines 


A local SEND command line must contain source 
and destination object specifications. 


A remote SEND command line must contain a source 
object specification. 


A RECEIVE command line (only used for remote 
transfers) must contain a destination object 
specification. 

The syntax for specifying an object is: 
{VOL|DIR} pathname, [SLOT n] [STN $nn] 
[FILE filename] 

A.3.2 Object Specification in Standalone FTS 

Command Lines 

If object is a volume: 

{SOS|PASCAL|DOS|CPM} VOL {unitnumber|.devicename} 

If object is a file: 

{SOS|PASCAL} FILE filename 

Note that the filename can be preceded by a 


Pascal unit number or a SOS device name if 
different than the prefix. 
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A.4 Syntax of Procedures 


A.4.1 Syntax of a Local Procedure 


BEGIN taskname [NOLOG] [EXIT]; 

[LIST; ] 

[NOLIST; ] 

[NFS nfscmd; ] 

SEND object [DELETE] TO object [REPLACE] 
[TO object [REPLACE]]...; 


[SET CHAIN programname [(FTS cmd filename) ] ]; 
END; 


Local procedures can contain multiple 
destination objects. 


A.4.2° Syntax of a Remote Procedure 


BEGIN taskname [NOLOG] [EXIT]; 

CONNECT TO SITE sitename [ALWAYS]; 

[LIST; ] 

(NOLIST; ] 

[NFS nfscmd; ] 

SEND object [DELETE] ID idname; 

[SET CHAIN programname [(fts cmd filename) ]]; 
END; 


A.5 Required and Optional Command File 
Components 


A.5.1 Required and Optional Components of a 
Local Transfer Command File 


Can contain one or more DEFINE command lines 
outside of procedures. 
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Can contain one PASSWORD command line outside of 
a procedure. 


Can contain one or more NFS command lines, 
either inside or outside of procedures. ` 


Can contain LIST and NOLIST commands, either 
inside or outside of procedures. 


Must contain one or more global SEND command 
lines or one or more procedures that contain 
SEND command lines. 


If there is a procedure that is to be executed 
automatically, a schedule command must be 
present. 


If there are no scheduling or RECEIVE command 
lines, FTS will complete globals and abort. If 
it is to continue running so that procedures can 
be hand scheduled, the command file must contain 
a “dummy” RECEIVE command line. 


A.5.2 Required and Optional Components of a 
Remote Transfer Command file 


Can contain one or more DEFINE command lines 
outside of the procedures. 


Can contain one password command line outside of 
a procedure. 


Can contain NFS commands, either inside or 
outside of procedures. 


Can contain LIST and NOLIST commands, either 
inside or outside of procedures. 


Must contain a MYSITE command line. Include USES 
and approprite string if necessary. 
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Must contain a SITE command line for every SITE 
to be communicated with. Include PHONE IS if FTS 
is to initiate the call to the named site. 
Include USES and appropriate string if 
necessary. 


May contain a global SEND command line, a 
RECELVE command line, or a procedure. Can have 
any number of each of these. If procedures are 
present, they require scheduling command unless 
FTS is to perform them only when it receives a 
call, or only when hand scheduled. If no 
schedule command exists for the procedures, a 
RECEIVE command line must be present to keep FTS 
running. 
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The Clock/Calendar Card 


B.1l Clock/Calendar Specifications 


The real-time clock/calendar card is included in 
the File Transfer Server package for the 
Standalone Apple //. This card gives the file 
transfer station the ability to maintain the 
current date and time, so that it can carry out 
events as you have scheduled them. In addition, 
entries into the log file are timestamped. 


The clock/calendar card consists of hardware and 
software components. The hardware is an Apple 
peripheral card manufactured by Nestar, with the 
following attributes: 


- Supplies year, month, date-of-month, 
day-of-week, and time in 24-hour clock 
notation. 


- Resolution to 1 second. 


- Accuracy is crystal controlled to better than 
+/- 0.005%. 


- On-card rechargeable Ni-Cad battery backup 
maintains time and date for at least 4 weeks 
without external power. 

- Write-enable and battery-enable jumpers. 

The software consists of a utility progran, 


SETCLOCK.CODE, to set the current time and date 
(see following section). 
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B.2 The SETCLOCK Utility Program 


SETCLOCK is a utility program is used to set the 
date and time in the clock/calendar card. Use it 
as follows: 


le 


Make sure that the WE (write enable) and BAT 
(battery enable) jumpers (small blue plugs) 
are in place on the clock/calendar card. The 
BAT jumper is normally disconnected for 
storage and shipment to avoid discharging the 
Ni-Cad battery. 


With the Apple powered off, insert the 
clock/calendar card in slot 5. Insert the 
other cards as necessary for the file tranfer 
server. 

Boot with any bootable Pascal diskette (e.g., 
"Apple 1") in drive 4. Insert your FTS 
diskette in drive 5. 


X(ecute #5:SETCLOCK to execute the setclock 
utility. 


The program will display 
THE CURRENT DATE AND TIME IS: 
MON 17-DEC-80 02:40:16 
DO YOU WANT TO CHANGE THE TIME OR DATE? 


Respond Y to proceed, and answer the 
questions as in the following example: 
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DAY OF THE WEEK (1ST 3 LETTERS)? TUE 
DAY OF THE MONTH (1-31)? 7 

MONTH (1ST 3 LETTERS)? FEB 

YEAR? 1981 

HOUR (00-23)? 18 

ENTER THE MINUTE AND HIT RETURN 
WHEN IT IS EXACTLY THAT TIME. 
MINUTE? 44 


The clock/calendar will then be set, and it 
will return to step 5. For the date and time 
set in the above example, it would display: 


THE CURRENT DATE AND TIME IS: 
TUE 7-FEB-81 18:44:00 
DO YOU WANT TO CHANGE THE TIME OR DATE? 
Respond N to exit the program. 


6. You may remove the WE (write-enable) jumper 
if you wish to prevent accidental reseting of 
the date and time. 


The clock/calendar will continue to maintain the 
correct time for up to four weeks when the Apple 
is turned off. The battery will be 
trickle-charged whenever the Apple is on. The 
clock/calendar card may be removed from the 
Apple (when power is off!) and the time will 
still be updated, but care should be taken not 
to short or touch any pins or contacts to avoid 
changing the rate of the battery-powered 
oscillator. 
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The Owlmodem 


The Owlmodem is a Bell 202 compatible modem 
developed by Owl Micro-Communications Ltd. for 
use with the Apple // computer. Owlmodem has 
auto dial and auto answer. 


C.l Installing the Owlmodem 


Follow the installation instructions in the 
Owlmodem Owner’s Manual. An exception to those 
instructions: you must insert the modem circuit 
board in slot 2 of ‘the APPLE. 


C.2 “USES “options 


The following optional keywords can be included 
in the <USES string? of the SITE or MYSITE 
command: 


NATIONAL -- sets CTS delay at 40 ms 
INTERNATIONAL -- sets CTS delay at 240 ms 
(default) 


CTS delay is the time required to change between 
transmitting and receiving modes under half 
duplex. 


For example, 


SITE there IS PHONE 893-9999 
USES NATIONAL; 
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Novation APPLE-CAT II modem 


The Novation APPLE-CAT II modem is a 
multi-function communications interface designed 
specifically for the Apple // computer. The 
modem is compatible with both Bell 103 and Bell 
202 series standards. By default, the modem is 
set to Bell 202 mode (0-1200 baud, half duplex). 
The modem may be set to operate at Bell 103 mode 
(0-300 baud, full duplex) if FTS is given the 
necessary instructions. 


D.1 Installing the Novation APPLE-CAT II modem 


Follow the installation instructions in Section 
6 of the Novation manual. There is an exception 
to those instructions; you must insert the modem 
circuit board in slot 2 of the APPLE. 


D.2 "USES" options 


The following option keywords may be included in 
the <USES string> of the SITE or MYSITE command 
to instruct FTS your intented usage of the 
modem: 


300 -- to select 300 baud Bell 103 mode 


1200 -- to select 1200 baud Bell 202 mode 
(default) 

PULSEDIAL -- use pulse dialing (default) 

TONEDIAL -- use touch tone dialing (only 


if the optional Touch Tone 
Receiver chip is installed 
on the modem) 


Additional options if operating under Bell 202 
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mode: 
NOVATION -- sets CTS delay at 1 second 
NATIONAL -- sets CTS delay at 40 ms 
INTERNATIONAL -- sets CTS delay at 240 ms 


(default) 
CTS delay is the time required to change between 
transmitting and receiving modes under half 
duplex. 
For example, 
MYSITE HERE USES 300 + NOVATION; 


SITE THERE IS PHONE 999-9999 
USES 300 + TONEDIAL + NOVATION; 
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Hayes Micromodem II 


The Hayes Micromodem II is a Bell 103 compatible 
communication system that can be used for the 
Apple // computer. It “operates” in originate or 
"answer" mode, and has pulse dialing and auto 
answering capabilities. 


E.l Installing the Hayes Micromodem II 


Follow the instructions in the Micromodem 
Owner*s Manual to install the modem hardware for 
use with FTS. You may insert the modem circuit 
board in any suggested slot. 


E.2 “USES” options 
Since all modem operations are automatically 
controlled by FTS, no USES options are 


supported. (300 Baud rate is the only 
possibility.) 
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The Hayes Smartmodem 


The Hayes Stack Smartmodem is an  RS-232C 
compatible communication interface that can be 
used to connect an Apple /// computer to the 
commercial phone system. The Smartmodem is Bell 
103 compatible, and operates with a data rate of 
0-300 baud. The Smartmodem has built-in auto 
dialing (touch tone or pulse) and auto answering 
facilities. It also accepts and executes 
commands issued under program control. In order 
for FTS to work with the Smartmodem, follow the 
guidelines in this Appendix. 


F.1 Installing the Hayes’ Smartmodem 


Prepare your D.C. Hayes Smartmodem for use with 
the File Transfer Server. 


l. Pry open the front of the Smartmodem (see 
page 2-5 of the Smartmodem Owners Manual). 
Inside you will find the configuration 
switches. Set these switches as follows, 
then shut the modem: 


switch # 1 2 3 4 5 6 7 8 
setting up up up 
down down down down down 


2. Use the RS-232C cable supplied by Nestar to 
connect the Smartmodem to your Apple. Be sure 
to insert the connector labelled "MODEM" into 
the modem, and the connector labelled "APPLE" 
into Port C of your Apple. Port C is located 
on the back of the Apple ///, on the side 
opposite the power switch. If you are using 
your own RS-232C cable, you must wire the 
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cable so that the following pin connectors 
are established: 


APPLE /// pins Smartmodem pins 
DB-25P Connector DB-25P Connector 

2 een ar errr ee 2 

aa 3 

4 mre renee 4 

bs escacacatn (ulenirnnarenietentereaneten nian 5 

8 eae 8 (N.C.) 

6) SSeS ee See Sees seeaso 6 

To sees een nae sneer 7 

20 mewn rrr tn 20 


3. Plug the Smartmodem into a telephone jack, 
using the cable supplied by D.C.Hayes. 


4, Plug the Smartmodem into a 110-volt power 
socket, using the cable supplied by 
D.C.Hayes. Turn the modem’s power on, using 
the small metal switch on the back. 


F.2 Configuring the RS232 Driver 


Note that Nestar ships a SOS.DRIVER file that is 
set up exactly for use with Smartmodem. If you 
are building the SOS.DRIVER file using the RS232 
driver as it is provided from Apple, you will 
need to modify some of the driver parameters . . 
using the System Configuration Program as 
follows: 


l. Back up your SOS.DRIVER file with a copy. 


2. Select the option “Read a Driver File" to 
read in your SOS.DRIVER 


3. If the RS232 device driver already exists, go 


F-2 3/1/83 


F. 


SMARTMODEM 


to step 5. 


Add the RS232 device driver to the current 
configuration by reading it with the Read 
option. 


Select the option “Edit Driver Parameter" to 
change the RS232 driver’s parameter. 


Select the Configuration Block option. Set 
the first value to 06 and the second value to 
00. This sets the baud rate at 300 and the 
data format at 8 bits with no parity. 


The configuration block with other default 
values should appear as 


Box# O 1 2 3 4 5 6 7 8 9 A B 
Value 06 00 00 00 00 00 13 11 DF 84 50 00 


Return to the main menu and select the 
“Generate New System" option to save the new 
system configuration as the new SOS.DRIVER 
file. 


3 “USES” options 


Use only the following options in the <USES 
string> of the SITE command or the MYSITE 
command: 


TONE -- for touch tone dialing 
PULSE -- for pulse dialing (default) 


For example, 


SITE headquarters IS PHONE 123-4567 USES TONE; 
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The Hayes Smartmodem 1200 


The Hayes Stack Smartmodem 1200 is an RS-232C 
compatible communication interface that can be 
used to connect an Apple /// computer to the 
commercial phone system. The Smartmodem 1200 is 
Bell 103 or 212A compatible, and operates with a 
data rate of 0-300 or 1200 baud. The Smartmodem 
1200 has built-in auto dialing (touch tone or 
pulse) and auto answering facilities. It also 
accepts and executes commands issued under 
program control. In order for FTS to work with 
the Smartmodem 1200, follow the guidelines in 
this Appendix. 


G.1 Installing the Hayes Smartmodem 1200 


Prepare your D.C. Hayes Smartmodem 1200 for use 
with the File Transfer Server. 


1. Pry open the front of the Smartmodem 1200 
(see page 2-5 of the Smartmodem 1200 Owner’s 
Manual). Inside you will find the 
configuration switches. Set these switches 
as follows, then shut the modem: 


switch # 1 2 3 4 5 6 7 8 
setting up up up 
down down down down down 


2. Use the RS-232C cable supplied by Nestar to 
connect the Smartmodem 1200 to your Apple. Be 
sure to insert the connector labelled "MODEM" 
into the modem, and the connector labelled 
“APPLE” into Port C of your Apple. Port C is 
located on the back of the Apple ///, on the 
side opposite the power switch. If you are 
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using your own RS-232C cable, you must wire 
the cable so that the following pin 
connectors are established: 


APPLE /// pins Smartmodem 1200 pins 
DB-25P Connector DB-25P Connector 
2. (See 2 
J Aessen 3 
4 re ee mom 4 
5 we i NAS 5 
8 === 8 (not connected) 
6. Stee eer 6 
Lenn en nem 7 
20 in 20 


3. Plug the Smartmodem 1200 into a telephone 
jack, using the cable supplied by D.C. 
Hayes. i 


4. Plug the Smartmodem 1200 into a 110-volt 
power socket, using the cable supplied by 
D.C. Hayes. Turn the modem’s power on, using 
the small metal switch on the back. 


G.2 Configuring the RS232 Driver 


Note that Nestar ships a SOS.DRIVER file that is 
set up exactly for use with Smartmodem 1200. If 
you are building the SOS.DRIVER file using the 
RS232 driver as it is provided from Apple, you 
will need to modify some of the driver 
parameters using the System Configuration 
Program as follows: 


1. Back up your SOS.DRIVER file with a copy. 


2. Select the option "Read a Driver File” to 
read in your S0S.DRIVER 
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3. If the RS232 device driver already exists, go 
to step 5. 


4. Add the RS232 device driver to the current 
configuration by reading it with the Read 
option. 


5. Select the option “Edit Driver Parameter" to 
change the RS232 driver”’s parameter. 


6. Select the Configuration Block option. Set 
‘the first value to 08 and the second value to 
00. This sets the baud rate at 1200 and the 
data format at 8 bits with no parity. 


The configuration block with other default 
values should appear as 


Box# 0O 1 2 3 4 5 6 7 8 9 A B 


Value 08 00 00 00 00 00 13 11 DF 84 50 00. 


7. Return to the main menu and select the 
"Generate New System" option to save the new 
system configuration as the new SOS.DRIVER 
file. 


G.3 “USES “options 
Use only the following options in the <USES 


string> of the SITE command or the MYSITE 
command: 


TONE -- for touch tone dialing 

PULSE -- for pulse dialing (default) 

300 -- to select 300 baud Bell 103 mode 
1200 -- to select 1200 baud Bell 212A mode 
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SITE headquarters IS PHONE 123-4567 USES TONE; 
MYSITE branch USES 1200; 


G-4 3/1/83 


INDEX 


ALWAYS 4-16, A-lff 
Apple // 
hardware requirements 1-4, 1-5, 2-2 
installation of FTS (see installation) 
Apple ///, 
hand-scheduling procedures 3-7 
hardware requirements 1-5, 1-6 
installation of FTS (see installation) 
Apple-CAT II Modem 1-4, 1-5, D-1 
applications 1-l1ff, 4-13, 4-33 thru 4-38 
AS (see DEFINE...AS) , 
AT 4-13 
automatic startup 
Apple // 3-1 
Apple /// 3-1 


BEGIN 4-11 
Bell 103 (300 baud) mode 1-7 


CHAIN (see SET CHAIN) 
clock/calendar card 1-4, 1-5, 3-7, B-lff 
Cluster/One Model A iii 
command files 3-3 thru 3-5 
creating of 4-lff, A-lff 
multiple 3-7, 3-8 
compilation of command files 3-5 thru 3-7 
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INDEX 


configuration 
Apple // network 2-2 
Apple // standalone 2-13 
Apple /// network 2-21, 2-22 
Apple /// standalone 2-33 
CONNECT TO SITE 4-16, A-lff 
CP/M 1-8, 1-9, 4-28, A-lff 
creating procedures 4-11 


D.C Hayes Micromodem II 1-4, 1-5, E-1 
D.C Hayes Smartmodem 1-5, 1-6, F-lff 
D.C Hayes Smartmodem 1200 1-5, 1-6, G-lff 
data to be transferred 1-8 
debugging command files (see compilation) 
DEFINE...AS 4-27, A-lff 
DELETE 4-8, A-lff 
DIR 4-4, A-lff 
disclaimer ii 
distribution diskettes 
Apple // network 2-2, 2-3 
Apple // standalone 2-12 thru 2-14 
Apple /// network 2-21 thru 2-23 
Apple /// standalone 2-33 thru 2-24 
DO 4-11, A-1ff 
DOS 1-8, 4-28, A-lff 


electronic mail 1-4, 4-13, 4-34 
END 4-11, A-lff 

ERRORS (see complication) 

EVERY 4-11, A-l1ff 

EXIT 4-14, A-lff 
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FILE 4-4, A-lff 
file server commands 4-25, A-lff 
file server directories 1-8 
file server volumes 

real iii, 1-9 

virtual iii, 1-8 
file transfer server station 1-1, 3-1 
floppy disk controller 1-5 l 
floppy disk drive 

for installation 2-2 

for operation (see Apple //, Apple ///) 
FOR ...TIMES 4-16, A-l1ff 
FS (see file server commands) 


“globals” 3-6 
H 


hardware requirement 1-4ff 
Hayes Micromodem II E-l 
Hayes Smartmodem F-1 

Hayes Smartmodem 1200 G-1l 
HOURS 4-11, A-lff 


ID 1-9, 4-16, A-lff 
IN (see RETRY IN) 
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installation 


Apple // network 1-5, 2-1 thru 2-11 


Apple // standalone 1-4, 2-11 thru 2-20 


Apple /// network 1-6, 2-20 thru 2-32 


Apple /// standalone 1-5, 2-32 thru 2-40 


hardware 1-4ff 
installation requirements 
Apple // network 2-2 


Apple // standalone 2-12, 2-13 
Apple /// network 2-20, 2-21 
Apple /// standalone 2-32, 2-33 


IS PHONE 4-16, A-lff 


keyboard commands 3-5 
keywords 4-lff, A-lff 


LIST (see protection) 


local transfers 4-3 thru 4-10, 4-34 


log file names 3-3 
log files 3-2, 3-3, 3-8 


macro definitions 4-26, A-lff 
Mail programs (see Messenger) 
Messenger 1-4 
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INDEX 


modems 
compatibility of 1-7 
installation 1-4, C-lff thru G-lff 
modes 1-7 
supported 1-4 thru 1-7, C-l1ff thru G-lff 
USES clause 1-7, 4-16, A-lff, B-lff thru G-lff 
multiple file servers 1-1, 1-2 
multiple networks 1-1, 1-2 
MYSITE 1-7, 4-16 


network interface card 1-2 
network transfers 1-2 
network workstations 1-2 
“No Errors Detected" 3-6 
NOLIST (see protection) 
NOLOG 4-14 


object specification 
local transfers 4-4 thru 4-10 
remote transfers 4-15 thru 4-24 
standalone remote transfers 4-27 
Owlmodem 1-5, C-l 


Pascal iii, l-1, 1-8, 1-9 
PASCAL 4-28, A-lff 

pathnames 

PLAN 4000 iii l 
procedures 3-7, 4-11 thru 4-15 
PASSWORD (see protection) 
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protection 
LIST 4-8 
NOLIST 3-6, 4-8 
PASSWORD 4-8 


Quick Reference A-lff 


RECEIVE 4-16, 4-24, A-lff 

reference A-lff 

remote transfers, 1-1 thru 1-6, 4-15, 4-34 
REPLACE 4-8 : 
required hardware (see Apple // or Apple ///) 
RETRY...IN 4-16, A-1ff 

rules to remember 


scheduling procedures 4-11 

SEND 4-4 

SET CHAIN 3-8, 4-14 

SET CLOCK B-l, B-2 

shared library software 2-2 
significant activities 3-2 

SITE 1-7, 4-16 

SLOT 4-7 

SOS iii, 1-8, 1-9, 4-29, A-l 
spooled files 1-8 

"STACK OVERFLOW" 3-8 

standalone FTS command files 4-17, A-27, A-lff 
standalone FTS transfers 1-1, 1-3 
Startemd.Text 3-2 
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SIN 4-6 
syntax 4-lff, A-lff 
SYSTEM.STARTUP 3-1 


TIMES (see FOR...TIMES) 
TO 4-4 
U 


USES 1-7, 4-16, A-1ff, 4-20, B-l thru G-1 
uses of FTS l-1 thru 1-3 


V 

¢ A \ 
VOL 4-4 
volumes 


non-directory virtual 1-8 
real iii, 1-8, 1-9 

types 1-8, 1-9 

virtual iii 
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Reader Comment Form 


This manual is one in a series that describes 
the use of the PLAN 4000 system. 


You are encouraged to use this form to 
communicate to Nestar any problems . or 
suggestions associated with the system. We would 
like your comments on improving the system 
itself, as well as on this documentation. 
Possible topics for comment are: clarity, 
accuracy, completeness, organization, coding, 
retrieval and legibility. 


No postage stamp is necessary if mailed within 
the U.S.A. 


Nestar installation location: 
Submitter”’s name 


Address 


Description of problem or suggestion: 


Please mail this form to 


Nestar Systems, Incorporated 
2585 E. Bayshore Road 

Palo Alto, California 94303 
Attn: PUBLICATIONS DEPT. 
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